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The NEW BBEdit 4.5! 


It.Doesn't Suck 


There has never been a 
better time to buy 
BBEdit- 

Upgrade from BBEdil Lite, 
Codewarrior, MPW, 

Symantec C++ or a number 
of other products for just $79. 

This offer is available direct 
from Bare Bones Software, Inc, 
to order, caO us at (617) 778-3100 
or visit us online. 




<http://WWW. barebones. com/> 
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h}^ Eric Gundrtim 


A Sense of Commlinfi'y 

One thing that separates Mac developer's and users from those 
of other platforms is our sease of community. We rend to seek oiii 
each other and band together to discuss our ideals, opinions, and 
Lite state of the industry. Macintosh users have created a variety of 
groups and organiziitions to help accomplish this. Consider events 
such as MacHack and the pletliora of Macintosh user groups 
arounti the world, No trihcr ct)mputcr platToriii has such a diverse, 
yet well connected community of users. 

1 suspect our sense of comniunity comes from our rkjLs as 
an excluded platform. Many readers will rcmemix:r tile early 
days of die Mac when the only way to get one into a business 
office was through the back clotir, under cover of darkness, 
Macintosh u.sers could noi call on ctirporaie supjKjn staff for 
a,ssistan<'e or advice alK>ut new software. In fact, often Macintosh 
users were pretty isolated, not having any other Macintosh users 
around. Macintosh users quickly overcame the limiiaiions of this 
isolation by locating other Macintosh users and cxclianging 
experiences. Not much lime passed Ix^fore many of these loose 
associations became formal user groups with regular meetings, 
special events, newsletters and bulletin boards. 

To my knowledge, Iw such tJrganizaCitni^s exist in the 
DOS aiid Windows communities. IVe seen groups of Windows 
users try to get started, but they never w^ere able to sustain 
themselves. Other platforms have had some success forming 
user groups, often with significant s|x>nsarship from the 
jilatform vender However, few such groups have attained the 
strength of community w^e Macintosh users take for granted. 
With so much changing ai Apple, the value of our community 
.seems more impcjrtani tiian ever. 

Sharing Technologies, Sharing Code 

'file success of die Mac is built upon many powerful and 
interesting technologies, in fact, these innovative technoh>gies 
are often a large part of what draws programmers to the Mac, 
enabling them to creaie soli ware tliai would nut Ik* practical, or 
even [xissible, in any other enviromiienr. However, with the 
recent popularity of the Internet, the world of computing has 
l>egim moving so fast ihal Apple alone canmH [jrovidc us with 
the leclmologius we need. We can benefit even more by sharing 
our own technologies with each other. 

Khapsf>dy offers many new opportimiiies for developers to 
leverage each t>ther’s work. The Rhapsody development 
environment is designed si^ecifically to make sharing ctxle much 
easier than it has ever been. In faa, diere was once a thriving 
market of third party libraries among NeXTSTEP develofxrs. 
They undersuxjd the value of not recreating code just because 
“it's not invented here." 


With the recent release of Rhaps<xly you have undoubtedly 
begun looking at flow your software can lie moved to the new 
platl’onii. As you review your own legacy technologies for 
Rhapsody, think airefuliy about which of your technologies 
represent significant differentia lion from your competition, and 
w'hat is just another implementation of the same thing everyone 
else has to implement. 

What you should find when you examine your technology is 
that most the value your product gives to a customer is how you 
have chosen to connect your various tei'hnologies together waih 
a useful presentation to the user That, anil one t)r two core 
Technologies developed frr>m ytjur own specific expertise ate 
wj^al your customers purchase. All the rest of your program is 
likely sup|X5il ctxle added to make your program easy to asc in 
a Macintosh environment. 

IxKjking at Rhapsody’s uk>1!x)x, Yclk>w Box, you will 
probal>Ly find that much of the code you strugglerl so long to gel 
|iist right on die Mac is already built into Yellow' Boxi diings like 
styled text widi nilers, drawing controls and such. However, 
there are many technological liules in Yellow^ Box; network 
]n-otcKois is a big one. Some of these holes liave been filled by 
NeXTS'lKP developers in the past, tret on-line and find them. 
Check out their objects and see it you miglit save money and 
release your software s<K)ner by licensing tliem. 

Keep in mind that the technology you license doesn't have to 
lie a pedecT fit. The dynamic binding fcitiums of the Rhajisody 
runtime iiukIcI allow piogni[iane[>i to gel in anti jiiodify the Liehavior 
of existing dijecLs, even without the origin^tl .souice txxle. You cun 
change a diirtbpiiny lilinirj^ to Wfiilc Ixaier witlt your application; you 
tun even tliange ht>w the Yellow liox objcxis work. 

If you don’t find die teehm>logy ytiu want already 
implemented by someone else, tlien yoti liave another market 
opponimiiy: ]><jri your Mac code to Hhapscxly, making it an 
independent library, and license il to other developers. If you 
don’t want to lie in the business of licensing ohjecLs, there will 
lie people who will do if for you. Today, fieople dtj dii.s in the 
Mat: community, and if niore develojK'rs take advantage of die 
seivke, more people wall offer it. 

liven if you don't want to license your tibiecis to everyone 
who wants them, diey still are a valuaiile asset. As you explore 
Oilier Rhapsody software, you may find another developer has 
a technology you would like to use. Thrtiugh private 
negotiating you may strike a deal to exchange some 
technologies, some ohjects. Both of you come out ahead, and 
our community gets more software, sooner. 

Share your technology with the rest of the community, and 
they will share w'iih you. As a result, we will build more 
software, faster and Ixitter dian developers of any other platform, 
and we will do so by working together. Ki 
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More Into Less. 
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Grow Witti Aladdin! 

The fastest growing company 
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HASP No. 1! * ^ 
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piracy. They’re protecting more products, on more phitfonns, with better protection - 
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Because MacHASl’ offers more security, more reliability and more 
features than any other product on the inarket. Only MacHASP offers 
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protection, and secure remote activation and updating. 

MacHASP supports the most advanced platforms, including all 
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networks. And because Aladdin is a liamsed Apple Partner, 
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To leant more about liow you can protect 
better - and sell more - call now to order 
your MacHASP Developer’s Kit. 
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Getting Started With Macintosh 
Programming: Circa 1998 



A long, long time ago, 1 wrote an 
article for MacTech Magazine (called 
MacTitlor, at the time) uaswering the 
question, “How do I get started with 
Macintosh Programming?'' About once a 
year, I u|>daie the article and do my best to 
pass it around to the community- This is 
the 199S version. 

learning to program the Macintosh 
can be incredihly rewarding and enioyabfe. 
Ive l:teen doing it for aix)Lit 13 years, and 1 
still get a diaige t)iii of seeing my thouglns 
and itleas come Lo life on my Mac's screen, 
[f the ideii of being able to build your own 
Mac applications sounds like fun to you, 
read on. Don’t let the lurnioil at Apple 
discourage you. I think Apj^le will be 
aioLitid for a gtx^d long time, 1 mean, think 
alx)ut it. Wc^Lild you rather use a Mac or a 
Windows machine? To me their is no 
comfiarison. 1 w^ant my Macintosh, 

A quick caveat: Just m> you know, 1 work 
ibr Metrowerks and w'rite Mac prograinming 
books and Ixjth are recommended in die 
following pages. If you have any douliLs 
alxiut die contents lielow, find a friend witii 
Mac progiamming experience (or hnd a 
newsgroup or on-line forum) and a.sk for 
yourself. 1 don't mindl ; ) 

Want to get in touch with me? Check 
out my wrb site <http://www,spiclerwork5.com> 
or send me email at 
<dmark@metro werks.com>. 


opinion, diere is no better way to sum your pn>gramiiiing 
education dian witli C. Tlie C programming language is the most 
popular programming language in the world, Once you know C, 
ytniVe got a language you can use on just about any computer 
in the world More importantly, C++, Olijective-C, and Java are 
all supersets of C. In other words, learning C will give you a leg 
up on learning any or all three of these imponant languages. 

To be fair, there are other (jpinions on the liest language to 
start witli. For example, there are quite a few people who tliirdc 
that Pascal is the easiest language to assimilate, I hough I agree 
that Pascal is a great programming language, and Ls less cryptic 
dian C, there are several reasons I’d go with C as your first 
language. For starters, C is much more popular than Pascal, To 
convince yourself of this, go into a w^ell-stocked computer 
lx)ok,store and count tlie Ihiscal, C, C++, and Java books, 
(dlances are, youJl find lots of C, C++, and Java books and 
perhaps one or two Pascal ixjoks (if any). The point here is, 
though some might say Pascal i.s the better languiige, C is 
clearly more popular and, therefore, I letter su[)[>orted. Because 
it forms the basis for hoih C++ and Java syntax, learning C is a 
better investment in the long haul. 

Still other people argue that novice programmers should 
Mart off by learning either C++ or Java as a fir.st language. 1 don’t 
like this approach. Don't lx* foeded. C++ and java are both 
object-oriented languages and retjuire Lhai you master two sets 
of concepts: die pniecdiiral teclmi<.|ues and syntax of C, as well 
as die complexities of programming with objects. Learn to crawl, 
then learn to walk, 'that way you'll have mastered twt> skills and 
each phase of the learning process is simpler. By learning C first, 
you'll master the basics of prcjcedural programming, Youll know 
the C langLiage. Youll also have a much easier time learning 
ObjecTtve C, C++, or Java. In I'act, youll find it much easier to 
master aj) Utree languages. You'll be able t() program in straight 
C if the siaiation calls for it. 


The Three Basic Sitps 


Start Off by Learning C 

So how do you learn to j:»rogram the 
Macintosh? For siariers, youll need to 
decide on a programming language. In my 


Then Learn the Mac Tcx>lbox 

Tlie C programming language, by itself, won't allow you to 
add Mac-specific features like windows, menus, icons, and dialog 
boxes to your prt>grams. Your C programming environment 
(mr>re on diat in a bit) most likely comes with .somediing called 
the C Standard Library which lets you do scjme very basic, text- 
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oriented input and output. You can ask the user for input from 
the keyboard, process that input, and spit out results, all in a 
scr(]lling text window known as liic console. Console-based 
programs have the smell of DOS and old technology. While they 
may get the job done, they are no substitute for the real thing — 
a true Macintosh program. 

To add all the cool Macintosh gadgets to your C programs, 
yoiril need to learn how to use the Macintosh Toolbox, a set of 
functions built into each and every Macintosh computer. The 
universal availability of the Toolbox en.sures that a window on 
your Macintosh looks and behaves exactly the same as on my 
Mac. There are Ttxilbox functions to create a new window, to 
implement a pull-down or popup menu, to draw in a window, 
drag the window around on the screen... in short, anything you 
w^ant to implement in the way of Macintosh user interface, 
chances are there is already a Tooltex function to do exaaly 
what you want. 

Then Learn an Object Programming Language and 
Framework 

Once you master the basics of programming using the 
T(X)lbox ami C, you1l probably want to move up to the next 
level — programming using ol>jects. just as the Mac Toolbox 
takes much of the work out of programming (by implementing 
the Macintosh kmk and feel so you don't have to), an oi^ect 
frameivork implemcnLs niucii of tlie stRicture of your ]>rogram 
and wraps it in reusable chunks called objects, 

Ohjective-C, Java, and C++ are all <)bject-oriented 
progianiming languages (progiiimming languages Lliat support 
objects). Tlierc are a variety of frameworks written in eaclt of these 
languages. Once you decide on an objea programming language, 
you'll also decide on a fmmework to work within. When you gel 
on bcjard with your programming language ofdioice, check out 
the WTjrk Metrowerks is doing witli the PowerPlant framework. 
J^owerTlant is currently the framework for MacinKJsh C+i- 
programrning. As A[)ple moves forward with Khaixsody (tlieir new 
oix^rating system), my guess is PowerPlant will also change to stay 
synchronizcxl with Rhapsody and to accominockite Objective-C 
and Java, the official languages of Rhafisody. 

Resources to Heij* You Get Started 

Books to Help You Learn C and the Toolbox 

If you are brand new^ to piognimming, you tnay want to 
check out iA^arn Con tbe Macintosh by Dave Mark (iliai*s me). 
Normally, I Lr\' to avoid recommending my own l)ooks to peoj>le, 
but if you are new' to programming or to the C ]:>rognimming 
language, I do believe Learn Cis the best place to stan. learn C 
assumes no previous programming cxpcTience and Lakes you 
through the process of programming using C. The hook comes 
with everything you need to get started including a copy of 
CodeWarrior Lite, a non-sa%hng veision of the leading Maciniosh 
programming environment. 


Most of die books, tools and products mentioned in tliiS 
aftJcle can be ordered from bev^eloper Depot. Their phone 
number is Outside the Uiand Canada, the:numbei: 

is (@35) ^^-9797. Their w^b s^ |s ^http7/www;dwdepot.com>i and 
email orders :are <orcters@devdepat.cnm>. 

Once you learn C (or if you are already a C programmer), 
you'll %vani a hook that teaches you how to make your programs 
take advantage of the Macintosh Toolbox. Foitunately, there are 
a great number of Mac Toolbox books. If you like the style of 
fj^arn C an tbe Maciniosh, check out the Macintosh C 
Programming Primer, 2nd Edition. 

But the Primer is just the tip of the iceberg, Take the time to 
go to a technical bookstore well-stocked in Macintosh 
programming books. Some other books to look for are 
Pwgram.ming Starter Kit for Macintosh by Jim Tnideau, Pou^*r 
Macintosh Programming Starter Kit f>y Tom ThcHnpson, and 
Foundaliom of Mac Pwgramming by Dan Sydow. You niiglit 
also take a loi-jk at How to Write Macintosh Software, 3rd Edition 
by Sam Knasier. Tliis last book is preiiy old, iiui ii still remains 
one of my favemtes. Of course, dierc are new Mac Toolbox 
books being written all the time and you should also be on the 
lookout for any Rhapsody-specific books as Applets new OS 
release looms closer to reality. 

Get CodeWarrior 

As you make your way through your first few programming 
titles, you’ll detlniiely want to start practicing your new found 
programming skills, liy far, the most recommended and most 
widely used programming environment on the Mac is 
CcxieWarrior. Q)de\X'hrrior is made by a company in Austin, 
Texas named Metrowerks. RemenilxT, 1 do work at Metrowerks, 
so ask your Mac programming buddies about CodeWarrior 

To fair, ilicrc are other ttxils you can use to create 
Macintosh applications, including the Macintosh Programnier's 
Workshop (MFW) from Apple, and a variety of visual 
programming tools as well. Go to die developer depot web site 
<http://wwvy.devdepot.com> and spend some time looking around 
Get to know the alternatives. Even if you do chtiose CodeWarrior, 
youJl l:x;nefit from knowing what else Is out tliere. 

CodeWanior is based on a front-end/liack-end architecture. 
The front end translates your source code (your C, C++, java, 
Pascal, or01>jeciive C siatements) into an intei nal representation, 
llie back end translates the internal representation into machine 
code targeted at a specific processor type. For example, for 
Mat.iniosh devciopmcni CodeWarrior features back-ends for both 
die 680x0 series of processors as well as for the PowerPC. 

More importandy, CodeWarrior also h;is back-ends for die 
kH 6 and Penlium series of proces,stjrs, as well as for a variety of 
odier prticcssors. That means you can write a Windows 95 or 
WinFI'r application completely on your Macintosh. Really! 
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MACWORLD Expo Conference & Exhibits: January 0-9, 1999 


You depend on the Maantosh to get work done faster, to stay connected with 
colleagues and friends, and turn your best ideas into action. Which is why you 
can't afford to miss the largest event that brings you the world of the Mac. 

Hundreds ol deui Products and industm insloDts! 

Only at MAO/VORLD Expo can you see and try thousands of products first-hand... 
learn from Macintosh experts through conferences and keynotes... talk with other 
Macintosh users and vendors... and stay on top of new developments that could 
impact your buying decisions. You’ll gain valuable insights into how innovative 
companies are unleashing the power of the Macintosh OS. 



cume euainate cust-sauing solutions lor: 

• Publishing, entertainment and multimedia 
■ Web site design and Internet navigation 
Networking, intranets and enterprise-wide connectivity 
Education and R&D 
Business and telecommuting 

ntane plans to aiieno hiaguiorld Enpo/san Francisco lodayi 



fr^ticisco 


nacwmi/rri 

ciiiernce 


If the Macintosh is part of your business, MACWORLD Expo is 
your lifeline. MACWORLD Expo/San Francisco is the industry’s 
premier Macintosh event and dramatic software introductions 
scheduled for 1998 may make this year's event the most exciting 
ever. Cain new insights into the future world of Macintosh... see 
the hottest and coolest new products... and get the inside view 
of the Macintosh OS platform. Register to attend today. 
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Far Petails! 


WWW. mac worlclexpa.cain 
or 800.645.EXPO 


The Macintosh Professionals 
Conference only at MACWORLD 
Expo/San Francisco, January 5-7. 

Please send mere iniormation on macuiorld Enpo 

□ San Francisco/Jan. 1998 

□ Attending □ Exhibiting 


Name 

Tille_ 




Company. 
Address_ 


City/Srafe/Z(p_ 
Phone_ 


email_ 

Mail to: MHA Event Management, 1400 Providence Highway, 
P.O. Box 9127, Norwood, MA 02062. Or Fax to: 7S1-440-0363 

THIS IS NOT A REGISTRATION FORM. 















































if your iilTiraLite goal is cross platform vviz;irdry» Metrowerks 
also ships vcrsicms of CcKleWarrior that run under Windows 9^, 
Windows OT, as well as under BeOS. (BeOS is a ctK^i new^ 
opeiating system from Be, hic ) If games are your tiling, 
Metrowerks also makes the official development environmeni ftrr 
Sony PlayStation (cch:> 1!) anti the Palm Pilot PDA. 

CodeWirrior a>mes in tw'o basic Mac flavcrrs^ a professional 
()ackage called CodeWanior, Professional iidition and a series 
designed for Ijeginncrs called CodeS^arrior^ Discover 
Pro^^ramnmIg Edition. CodeWanior Pro Is a professional 
dcvelopmeni en%ironment and comes with everything you could 
ask for in a programming look It ships with C, C++, Java, and 
Pascal front-ends, as well as with P<>werPC, 680x0, and x86 
backencLs. CodeWhrrior Fro inti tides iJie latest beta Rhapsody 
development Lcxils xs welh ineJuding an Objeclive-C front end. 
You also get a series t>f electronic (non-printable) programming 
lKM)ks, including learn C on ihe Macinloshf Jj^arn f>+ on Ihe 
MacifUosh, Programming Starter Kit for Macinlosb, and 
CodeWanior Software Development Using PouwPlani as w ell as 
a series of Apple Guide files to help ytru get started, and a 
boatload of sample ccxle, extni tix>b and demos. 

W1ien you buy Code Warrior Pro. Metro werks throw's in one 
year's worth of updates for free. Typically, Metrowerks releases new^ 
versttins of CodeWanior in May (in time for Apple's WoM Wide 
lX"velo;xT’s Conference, or W^'DC) and Octolier. Prior to the May 
1997 release, CodeW'arrior Pro was called CodeW'arrior Gold and was 
released tliree times a year, 'fhe version nuiiil)er was reset to 1 with 
the May CWPro release. At the s;mie time, Metrowerks moved to tw'o 
releases a year. For example, in January '97, Metrowerks released 
CWll. CodeWamor Pro 1 was released in May. CtxleWarrior Pro 2 
was released in October. You get the idea. 

If you plan to do any commercial software development for 
the Mac, Ct)dcWarrior Pro is a mu.st. A one year subscription is 
Once you are registered, a 1 year upgrade is 

If that price seems n hit steep, check out CodeWanior 
DiscotH.r Programming Edit ion. Discover Programming is a non¬ 
commercial Mac-only version of CtKieWarrior i^ro, 't hough you 
gel C, C++, Pascal, and Java front ends, you only gel the 680x0 
and Java byte cckIc backends. The (>80x0 back-end means tliat all 
the programs you build will be in 680x0 native format. '1'hey'll 
run ju.s! fine on a PowerMac, hut in emulaiion nunle (a bit slow'er 
than PowerPC native mode). If you are just learning how lo 
progiani, you likely won't even notice the difference. As you’d 
exi^ect from a learning ethtion, you also get all the electronic 
Ixxiks and siimple code. 

CoileXXdrrioK DLscotJer Programming Pdition is only $79. If 
you upgrade lo CudeWarrior Pro directly through Metrowerks, 
theyJI take $79 off the upgrade price. If you are jiust gening 
started, Discoi^T Pr<)grammingfor Atacintosh Ls a great deal! 

By the way, there are versions of CodeWamor Discover 
Progrennming Edition for )x>th Macintosh and Windows. They’ 
each list for $79. 


Ck!ttiiig started witJi CodeWarrior 

Once you have Code Warrior installed, you 11 want to learn 
how tt) use in Stan off by running the Apple Guide tutorials. 
You 11 find them under the Help menu. There are tutorials tliat 
show you how to create C and Pascal console [)rojecLs, and C 
and Pascal Mac Ttxjlfxjx projects. ITiere are also a series of Java- 
specific tutorials. Take the time to gtr through all the tutorials that 
apply. An important part of learning how to pnjgram is mastering 
your development environment. 'Phe CodeWarrior Integratcxl 
Development Environment (IDE) is a sophisticated and powerful 
application that will rake some time io letirn. The tutorials will 
lielp yf>u get started. 

Once youVe CTcaled .some simple applicatioas, dig into the 
dot'umentation. Yt)u1i find answers lo many of your early 
([ue-stions in the H )h LIser'.s Guide, Once you feel comfortable with 
the IDE, go l>ack anil lake the CodeWarrior Debugger tutorial. 
You'll dien want to sjx-nd some lime with the Debugger manual. 

More Bcxiks arid Too lx 

Once you have yotir dcvelopmeni environment inslalled 
and have the basie.s of Macintosh C programming under your 
lx:lt, you1l want to add a few more items to your programming 
arsenal For suirtenv, yoifll need a i^opy of inside Macintosh, die 
bible of the Macintosh T(K)lbox. Inside MaLintosh consists of a 
series of more than 2> bcK)ks, eacli of which completely 
dc.scrilxis some portif>n of ihe Macintash Tcxilhox, 'Phese Ixtoks 
are indispensable, l liese books are also expensive, espedaUy if 
you intend to buy the eniire .series. 

Though it IS certainty nice to have the printed copies of 
the inside Macintttsb books, consider buying the electronic 
version instead. 1'he Inside Maciniosh CD-ROM sells for 
L]S$89.9$ and includes the complete text of most every Fmide 
Macintosh volume in a cross referenced and hyper-linked 
form. Get iliis CD-ROM. 

Of particular interest is the volume callei! Inside Macintosh: 
Macintosh Human Interface Gtiidelines. This book covers 
Apple's human inicrface .standards in great detail. They w'ill teach 
you how a Macintosh application Ls supposcii to liehave, from 
the proper IfKiition of OK am! Cancel fiutlons in a dialog Ixjx to 
the [iropcr way to position jnultiple windows on the user’s 
tiisplay. Though the inicTfacc standards mighi .sittan excessive, 
it’s that strict attention to detail that makes a Macinto.sh 
applk'alion .so recogni?iible. Read this lx)ok. 

Another imponanl tool that you1l want at your disposal Ls a 
re,source editor. Macintosh progranis store [irogrant-rclaied data 
such as icons, cursors, window descriptions, and text in a sjx^cial 
[)oition of your application file called a resource fork. A resource 
editor is essential for yt>u to be al>le to edii your appiit:ation's 
rescHirces. Apple created a widely distribtited resource cdii«)r 
called ResEdii. Though ResEdit does a relatively adequate job of 
editing most resources, onc'c you get into some .serious 
Macintosh programming, you 11 quickly discover ResHdifs limits, 
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If you want to be in the know, then you 
need every article published in the first 
12 years of MacTech* Magazine and 
Apple’s develop” issues 1-29! 

...in TTifNK fnrmatf 


So hurry, pick up the phone, fire up 
the e-mail, launch that fax machine, 
or simply drop by our web site and 
order yourself this new release of 
the MacTech" CD-ROM. 


Almost 1600 articles from aU 139 issues of 
Mac'l’ech Magazine (1984-1996) 

Includes Apple develop issues 1-29 

Improved hypertext, improved indices, and a newTIDNK 
Reference Viewer — for lightning quick access! 


New hyperlinks between articles 

lOO-f MB of source code — ase them in your applications, with no royalties! 

Full version of THINK Reference — the original online guide to Inside 
Macintosh, Vols. I-VI 

80MB of FrameWorks/SFA archives and the most complete set of Frameworks 
arcliives known 


Sprocket™! MacTech's tiny framework tliat compiles quickly and supports 
System 7.5 features 


Tlie best threads from the Mac programmer newsgroups plus thousands 
of notes, tips, snippets, and gotchas 

Popular tools that Mac programmers use to increase their productivity and 
much more! 
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A company called Mathemaesthetics created a program 
called Resorccrcr dial goes well Ix^yond what ResEdil can do. 
Mathemaesihetics charges US$256 for Resorcerer, though 
students can get it for half price (you'll need a saident ID or 
educational mailing address to qualify^). 

You can write to Mathemaesthetics at 
<sales@mathemaesthetics.com>. Their web site is 
<www.mathemaesthetiG.com> (big surprise there) and their phone 
number is (303) 440-0707, You should definitely check out their 
web site, both for their explanation of what Resorcerer can do as 
well as for new versions, patches, and possible price changes. 

Of course, tile net is also a critical resource. In addition to 
the myriad of programming related sites, you might want to 
check out this aitoriai for CodeWarrior users in both Rascal and 
C at <http://wmAmbrosiaSWxom/alt.sources,rnac/nnacimosh-c/>. 

You should also check out this gioup of Mac programmers 
that help with online self study, MOSl' at 
<http://www,atmed.org/most/>. 

And Ap[ile offers courses and certifications at Dcvekjpcr 
University at <http://www.devworld.applexom/dev/du.shtml>. 

The Metrowerks .site, as you might expect is 
<http://www.mGtrowerks.com>, 

Finally, check out WarriorWorld, a site for all CodeWaiTiors 

<htTp://www.codewarrior,org/>. 

Yt>ur next .step should be a visit to a hard-crore tet:hnic:al 
bookstore. At tlie very lea.st, pick up a copy of C, A Reference 
Manuaf by 1 larbison and Steele. 'Fhis book, aft'ectionately known 
as HScS, is a terrific C programming reference that will get a lot 
of use as you gain experience writing C code. Tliere are also a 
numlier of books that describe data structures, searcliing aiKl 
sorting algorithms, as well as tecliniques to help avoid common 
programming errors. Some of these lx)oks are language 
indcfKaKlent, wliile others are specific to C, Pa.scal, Oi)jectivc-C, 
or Java. Find a writing style tliat you feel comfbnable with. If you 
find any that you finind pank tilarly u.seful, plea.se do drop me a 
line and let me know. 

Mere's a list of lKx:>ks the folks at Metrowerks recommended; 

Language Reference 

• Advanced 6-^+ by Cop lien. 

• The Annotated C++ Reference Manual by Ellis and Stroustnip. 
■ 577, Tutorial and Reference Guide by Mu.sser and Saini, 

Addison Wesley. 

• C, A Reference Manual by Harbi.son t'i .Steele. 

• C++ Primer Plu^ i+y Stephen Prata, 

• C++ 77?^ Complete Reference by Herljen Schildt. 

• The Emhttion of C++ Programming by Stmustrup. 

• The Standard C Library by l\|, Piaugen 

• The Java Class Libraries: An Annotated Reference by Patrick 
Chan and Rosanna Lee. 

• The Java Lxingiui^e S})ecification by Jame.s Gosling, Bill Joy, 
and Guy Steele. 

• 'the java Programming Language by Arnold and Gosling(the 
guy who invented JAVA). 
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• Java Programming for the Internet by Thomas, Patel, 
Hudson, and Ball. 

Avoiding Language Pitfalls 

• Fffective C++ and Mori" Fffective C++ by Sa>tt Meyers. 

• Code Complete and Rapid Development by Steve McConnell. 

• C Programming and Dynamic Memory Management by 
Daconta, QED publishing. 

• C++ by Cline & Lomow, 

• C Pointers and Dynamic Memory Management by Michael C, 
Daconta, 

• C++ Pointers and Dynamic Memory^ Management liy Michael 
C. Daconta. 

Alg(»Hthfns 

• Algorithms in C by Sedgewick. 

• Data Structures and C Progratns by Van Wyk, 

• The Knuth Computer Science series. 

• Inlroduction to Alganihms by Tlioina.s Cornicn, Charles 
Liesersem, and Ronald Rivest, McGraw IlillATie MIT Press, 

• Intnk^iucing Algoritbtm in Pascal by lliomas W. Parsons, 

Software Design 

• Code Complete by Steve McConnelL 

• Dehu^^ing Macintosh Software by Othnier and Strau.s, 

• Debugging the Development Process by Steve Maguire, 

• Design Patterns: Elements of Reusable ObJeePOriented 
Software by Erich Gamma, Itidiard Helm, Ralph Johnson, 
John Vlissides. 

• Demloping ObjeePOriented Sojlware for the Macintosh by 
GtjlcLstein and Alger. 

• iMrge-scale C++ Sofiware Design by John Likos, 

• No Bugs by Tliielen. 

• OhJeePOriented Analysis and Design With Application- by 
Boodi. 

• Object Oneuted Programming by Peter Coad tk Jill Nicola. 

• Rapid Detfelopment by Steve Mc'Connell. 

• SoJ'tware Implementation by Mic'hael Marcoity. 

• SoJhmre Tools by Kerniglian and l^lauger. 

• Taligent's Guide to Designing Programs. Weli-marmered 
Object-Oriented Design in C++, J'aligent Press/Adclison 
Wesley, 

• Wnting Solid Ctkie by Steve Maguire SH 


Visit MacTech® Magazine’s Web site! 

http;//www.mactech.conn 
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InsiatlerMaker 4J Urn 


H \ The reason we call 

Cufiiiileie liiKlalhilion Soliil ioti is because 
p we inelude I^V(^rjthing yflil nn(*(l to prepare a 
professional package of files for installation on your'^ 
users’ machines. An installer, updater, and an 
uninstaller are just three components included for the 
same price one of our line competitors charges for 
just, the installer. And weVe Just, mided ^ 

H i electronic transactions, ShrinkWrap, and 
Hi improved internet conftgaration support. 
m Using our installer reduces technical support * 
calls due to end-nser errors during installation, ^ 
saves disks (if distributing on fir>iipies) or downloml 
time (if distributing on-line). And the puzzle will be 
solved. You’ll have eveiy piece in place. 

Download a Irt'P, fidly-fnnctional copy of 
InstallerMaker 4.1 from www,aladdiiisysxom, or 
call C4()8) 761 -fi20() and ask for Developer Sales, d 


© 1993^ Afcjddin SystHiE. Iric IBS Westrttige Drive, Watsurivilfe, CA9607B. Fax; 761 £206, 
Inforixl: own AtllApnlfiJ jnk: AIjMXJIN Siirffll inflfiTaKmito ts n hrnflfirTwH 
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TOOLS OF 
THE TRADE 


hy Christopher I lull 


PowerKey Pro 600 


This is not your father’s 
powerstrip... A look at the 
latest in computer 


automation technology 



f igure L Sophisticated Cicuits' 
PotverKty Pro 600, 


TiiAT Special Morn 

It's a special holiday monimg and gift 
wrapping is Hurrying as the gadgets and 
gii:mcxs are rif jjxi^d Ofx:n by eager hands. As 
the children shriek over their eMates and tlie 
adults wince at their credit card bills, what 
should an intrepid Mac System Admin¬ 
istrator find as his gift hut.., a ptjwer snip? 

"'riiey couldn’t gel me a tie or 
cummerbund or something else 1 don't need? 
My gift's another power strip?’' our heroic 
Mac loyalist laments ungratefully. With a 
brave eye, he slowly opens the elegant 
biodigradable cardboard box to kjok at 
Sophisticated Circuits' newest toy, the 
PowerKey Pro Model 600, 


Rummaging thru die txjx's contents, our Holiday Geek 
wonders, ^Why would a power strip have such a strange ADB 
cable? And two R>11 phone jacks? And software?'' Rushing to his 
Mac, he excitedly installs the software, shuts down, and moves 
all of his fx)wer cords from his brain-dead power strip to the 
suddenly fascinating PowerKey. 

Perhaps this happy scenario will be repeated for many 
users this year, because the PowerKey Pro 600 is one of the 
most useful geegaws a Macintosh-using Inspector Gadget 
could receive. Under the mild-mannered guise of a 
handsome power strip, the PK Pro 600 hides a powerhouse 
power controller with all the .smarts needed to control its six 
outlets from your Macintosh by keystroke, schedule, 
telephone or AppleScript. 

What Can It Do - The Basics 

As an inidligcnt power strip, the PowerKey Pro 600 can do 
simple and useful tasks; even merely staning up the Mac can be 
enhanced. Older Macs which lack “soft" power (that is, kcy!x>ard 
power on, such as a Power Mac 6100 series lacks), can now 
enjoy tliat convenience. Furthermore, if a system has many 
periphends to lie started up lietbre the CPU (such as hard disks 
w'irh a lengthy spin up), selling the Cl^IJ’s cmilet with a delay 
allows true onc-toucli startup. 

Starting up or shutting down on a schedule, as well as 
saving energy by [X)wering down an idle Mac’s monitor, is also 
easy with the PowerKey\s very well-designed software, 

Setltp and Use 

Seiting up the PowerKey is a breeze. The hardware 
ret I u ires nary a moment of tliought to properly hook ADB, the 
phone and the power cords together, while the software 
requires little more than a rebiKX and .some preference setting. 
Sophisticated Circuits lias wisely given a switch for each outlet, 
the ability to disable the switches and, for the careless scripter 
who PowerKey’s his Mac into not being able to bool, a simple 
hardware override. 


When not whipping out aitictes, Christopher Ilall <chri.stnpln^r@mat:t:onnetlxom> is senior consukaiit for the chrysalis 
group/thc Software Brewing co. of Memphis, TJN and has lx:en ctmsiiliing since 1985. Tie is als<i selling a lovely home in 
Mempliis whitli would cost $415,000 if it were in California. (5 hHj 2 Batlx pool, ethcrnel, eliciip ISDN, $140K OBO.) 
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Figure 2 Hardware Setup tf the FotmrKey Fro. 

The PuwerKey Editor \h l!ie interface iv die Pt>werKey 
Extension, the background-only application that does the real 
work. A simple .Schedule window shows all the events created 
for a given PowerKey. Considering that liUjlUple PowerKey Pros 
can be daLsychained over ADU, this control is appreciated for 
complex power control needs, such as an array of web servers. 


Mmmmsaum Chrlstopner's PauierKeu Pro 600 

h Monitor t«99l» I 

^ L£J VFwrr k8ystroke »V* " is pressed: 


t> after phone 

^ Vhen system is Idle more then 10 minutes, if system was started by , 


^ Monitor Idle 

Vhen system is Idle more than 10 minutes; 

(3 Turn Monitor off. 

Wait for user activity. 

(3 Tyrn Monitor on. 

iST Yhen phone rings *Short“Short * 4 times: 


K ^ TitnbuMu on 

^ Vhen phone rings "Short-Long-Short" 1 times, vhen the system is... 


b Start Up 

^ Vhen * Rover On " key is pressed; 


h User Shut Dovn 

^ O Vhen sustem shuts dovn: 


[ Neuj... ] [ Edit... ] [ Delete ] 


Figure S Fou^erKey Schedtde. 

Controlling your system by events is quite easy. A 
l^owerKey event consists of a trigger, which can be modified by 
quaiiGers and actions. For example: At 9AM on Mon, Tue, Wed, 
Thu and Fri, not between Wed, Oct 1, 1997 and Tue, Oct 7, 1997: 
start Lip the computer. In other words, it's easy to set up your 
Mac to IxjoL every weekday, but the week you're away in the 
Virgin Islands. 


Want to suggest an article for tlie 
magazine? Send your suggestion to 
<mailto:editorial@inactech.com> 


Euent Name; [on but Uacationj 


k At 9;00 AM on Men., Tue, Wd, Thu ^»d Fri, nflt betv#^ Ved, Oct t, 19^7 
and Tue, Oct ?, T997: 


Trigger [ Dags of Llieek 


▼ [[ Qualifiers.-, ] 


S M T UJ T F S 

Repeat euerg PI3I30S1KID at 


9:00 RM 


start up tlw carr^uter 


^ [ NeiU flCtiOFl.,, ] 
( Edit Rclion.- ] 

f Delete Rction ] 


[ camel ] OK ]) 


Figure 4. We Fmtt ISdttor. 

It IS jusE as easy to create events that toggle any device's 
outlet, such as your modem or printer. 

Event I'riggers 

The PowerKey has two general types of triggei^: time 
triggers and system triggers. Time triggers arc used to create 
automatic or repeating events while the system triggers actuate 
on certain types of t:ompiJter or phone line activity. 

Time triggers include: Once Only, Repeating, Days of Week, 
Day of Month, 

System triggers include: Towei' On" Key Pressed When 
Phone rings, Phone Tones Heard, When Hot Key Pressed, When 
system is Idle, When Power Rerums, At Shut Down, When 
System Crashes, and When I’imer Expires. 


^/Once Only 
Repeating 
Days of WbbK 
Day of Month 


Toioer On” Key Pressed 


IDhen Phone Rings 


Phone Tones Heard 
LDhen Hot Key Pressed 
lilhen System is Idle 
IHhen Pouier Returns 
Rt Shut DoLun 


iHhen System Crashes 
When Timer Enpires 


Figures. Triggers. 
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Event Qualifier!) 

Qualifiers refine Ijow and when a trigger activates^ all of a 
trigger's qualifiem must l^e true for the trigger to fire. For 
example, a When Phone llings trigger could have cjualifiers dial 
allow' it to work only after business hours and on weekends. 
Qualifiers vary depending on the type of trigger, but include: 
Time Range, Date Range, Days of Week, System Idle, How 
Started, and System Running, 

Event Actions 

'I'he PowerKey has a very useful range of actions. In 
addition to the exfxrcLcd Switch Outlets, Start Up Computer, Shut 
Down Computer, and Restart, die PowerKey supports Execute 
Script, Execute QuLcKey, lype a Keystroke, Wait, Open File, 
Quit Application, Mourn SCSI Devices, Answer Phone, Add to 
U>g and External Actions. 

As an event is constructed, a natural language representation 
is crafted in the Event Editor Dialog, making the PtjwerKey one 
of the simplest-to-u.se scripting Uk>!s available. 


Choose action type: 


[7]Switch Outlets 


^ Shut Down Computer 

i- 

<1 Restart 


^ Execute a Script 


Q Execute a QuicKey'” 


©Type a Keystroke 


Wait 


<^0pen File 


HI) Quit Application 


O' Mount SCSI Devices 

o 


[ Cancel ] 


Create 


1 


Figure 6. Actions Types. 


The Not-So-Basics 

Remote Coolrol 

If that were all the PowerKey could do, ii would Ijc useful, 
hut the PowerKey is de.signed to really shine as true lemote 
contKil for your system's power Lbtening in on the phone line, a 
Pow'erKey Pro can do any event based on the phone ringing any 
number of times, hearing certain touch-tones (DTMF) for security 
ccxles, or even distinclive-ring patterns. It was tremendously 
useful to teach my PowerKey to lx)ot my Mac in any number of 
different startup configurations. Because an AppleStTipt (or 
QuicKey or Frf)nlier siiript) can Ixr part of an event, altering what 
software was active at relxxjt is relatively simple. With a phone 


call on a distinctive ring (short - long - short) and the entry of a 
code, my personal Mat' can nel)<K>i for Apple Remote Access, fax 
rec:eption, or a tjuickie web server with never a conflict over 
which applic'alion deserves the serial port. When it's been idle Uir 
20 minutes, the System reb<x)LH to the preferred working 
configuration. As an added Ixjnus, if tlic Mac was started up or 
relKXJted over the phone, the monitor doesn'T need to be 
powered up, so a nickePs worth of energy' is saved. 

The only minus with the telephone control is that the 
PowerKey doesn't understand ISDN lines or PBXes, hut that is a 
small issue; having a dedicated line for computer t:ontroi can be 
wise for a mission critical server. 

Server Control 

No Mac OS server should be without a PowerKey. (Aj^ple, aie 
you listening?) The Sender Restart OiXion, a standard feature of the 
PK Pro 600 (and an option on the PK PrtJ 200) is a System 
Administrator's dream. When a server hangs, the When System 
Crashes trigger can be set up to lesian and make life good again; 
when the utility company decides to take control of your server's 
life bUxxJ, the When Power Relums trigger c:an also rt'set 
whatever’s needed. Many a dollar and much SysAdmin sleep c^ 
lie saved by this autfimation. When combined with the secure 
telephone cxinLrol of your server, a SysAdmin might actually he able 
to never touch the server physically exc'ept to ieplac:t* hardware. 

Maedess <)peralii>n 

A Macintosh is needed to program the PowerKeyPro, but a 
u.seful feature is that a unit's scheduled events can be 
programmed at a Macintosh and then placed anywhere. Any 
Outlet swiu:hing action triggered on scheduling or telephone 
interaclitm is fully usable. 

I'he User 'fimer 

The PtiwerKey ''pings” the Mac every 10 secxinds to 
determine if the Mac is running; it if fails, the When System 
Cmshes trigger c^n be fired. Qinversely, a mission critical 
appl!caii<jn that musi lx: up and amning 24/7, such as a Webserver 
or database, CiUi set the PowerKey User llmer to count down to 
a restart. As long as the LIser Timer is reset by llie application, the 
PowerKey serves up fiower. If the app craslies and cannot reset 
the User Timer, Uie PowerKey can restart the Mac and a scrip! or 
startup alias can have the mission critical appliaiiion back without 
a System Administr^uor's aaion. Bravo, Sophisticated Circuits. Not 
only dexfs every Mac OS server need a PowerKey, but every Mac- 
based info kuisk. (This feature cm l>e implementcxl witliout 
AppleScript by sending an Apple event ttsing Event Class 'PKPf 
and Event TD Tickl) 

Custom Actions 

If tlie actions the PowerKey Editor offers aren't quite 
enough, you can write your own External Action. External 
Actions are nothing more tliat HyperCard XCMDs. To make ilte 
External Action available to the PowerKey software, the 
compiled XCMD must lx.- placed in a file of type/creator: 
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Xmi/PKPr :incl pliiceci in the the PowcrKcy Folder in the the 
IVeferenccs folder. After a rcf^tait, tiie new Extenial Action will 
ap|>ear at the lx>ttoni of the Action Selector List. 


Bt-Tper 

A l^tJwtrKty cxienyl tkqrcr, plays your beep souml through the Mac's 
speaker Ikeper lakes only one paranieier, Uic uihiiIki' of litucs to beep the speaker 
Thts code is available on the BiwrKcy iiistsUUUon disk. 

j|fiiiclude<ldypGrXCmd .h> 
jfinclude <striiij^. 
jlinclude <A4Stuff.h> 

static yoldxcinti...paraEn„to_string 

( Handle param. char *str. short max^Ian Js 
sLalic longxcjnd;_parain to nam C Handle paran ): 

pascal void main ( XCmdPu ph ) 

// Setup base reitisters so wc can access global variables. 

EtiterCodeResource (): 

pb ) rc t II rn Va 1 lie ^ nil:// Setup return value field of pb 

if { pb-^paramComit = 0 ) 

SysBeept OL ); 
else 
[ 

long n. count; 

count ^ !teu]d_parafti_Lo^niiiB ( pb->ps5ramRffll ); 
for ( n = 1; ti <= couni; ii'tf ) 

SysBeepi OL ): 

I 

// Restore base registers before wc return 

RxltCodeResouree{); 


static void xcnid_paraa!_to_stting 

< Handle param* char *str* short iiiax_lau ) 

1 


SignedByte stare; 


if [(param = OL) || (sLt “ OL)) 
return; 


state = HGstState (param); 

Hl.ock (pa ram); 

fitrncpy (str. *paraiii. max len); 
sir [inux_len] 'VO": 


HSetState (paraiu, i^tate): 


return: 

J 

sLaLlc long )<cnid_parain_to n\m ( Handle parara } 
f 

Jong ruuD = OL: 
char temp LZ56j : 
char *s: 

temp [0] = ■\0“; 

xciiid_parafi_to_str Ing {param* temp* 255); 

K ^ Lemp + sLrspn (tempp '' ; 

Ctofset (s); 

StringToHum { (StringHtr)s< Stnum) : 

return num; 

I 


PLATFORMS: APPLE SYSTEM 7' 


Q: What does it take 
superior client/server 
A^ASUPERiORSEm 



RESULTr 

A solid, economical, 
easily deployable 
product that fits 
your needs. 

• Portable 

• Sealable 

• Exceptional l^ribrmance 

• Flexible 

• Easy Server distribution 

• Convenient OEM terms 

FAIRCOM^ 

Server 


STAttY with the 
most advanced client- 
side SDK on the 
market: c-tree'^^ Plus 
at $895. 

■ CompEete "C" Source code 

• HOYAL'I’Y FREE 
(Client vSidc) 

■ Multiple i^upported 
protocols 

• Fast, portable, reliable 

■ Povverful features like 
transaction processing 

# Win95, NT, und 
Windows 3.1 ready 

ADD a strong, 
multi-platform, 
in dustri a ^strength 
Server that supports 

» File mirroring 

* Heterogeneous networking 

* Aulomut.it: disaster recovery 

• Multi-threaded desJEii 

* Best price/perforTn a rate 
available: from $445- $3745 


You can't find a batter diant SOK with these features! 
Over sixteen yeera of proven reliability and parformancfi- 
No one elae aupporta over 30 platforms in this price range* 



c-tree Plus' 

• tToniplele C Source 

• Single/Multi User 

• t'lieni7Hervtr (o|>tioiTal]i 

• Full ISAM functionality 
» No Rtiyallies 

• Transaction thnoccssing 

• Flxiaj/Variatak; leiiglli Reeonk 

• High Speed Data/Index 
Caching 

• Batch Operations 
■ File Mirroring 

• Mulllple Contexts 

• Unsurpassed Portability 
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AppleScript and The PowerKev Pro 

Alrhough Me to ain any OSA-compliant script, the HowerKey 
iLscli' IS st:ripUiblt.\ so any event t.an Ixf .scripted and executed. The 
Core Suite's Standaid Events are supported (Gel Data, Sei r>aia. 
Quit Application) as well as PowerKey's own suite. 

execute: execiite a specified event 

execute reference 

Class application: An applic alicai j^ro^ram 

Klements: 

unit hy numeric index, hy name 
Prot>enie,s: 

version string [r/o] 

timer integer 

log file spedricalion [r/ol 

Class unit: a PoweiKey unit 

Plural form: 

units 

Elements: 

outlet by numeric index, by name 
event by numeric index, by name 
Properties: 

oanie string 

serial number integer [r/ol 


Class outlet; an outlet 

Plural form: 

outlets 

Properties: 

name string 
level integer 

Class event: an event 

Plural form: 

events 

Properties: 

name string 

serial number integer [r/o] 
owner type class 
enabled Ixjolean 

Scripting die PowerKey is simple, whether one uses 
AppleScript Frontier, or QuicKeys, A .simple (and rather useless) 
saipt to flash Outlet ^ 6 on is 

on I pause I(length) 
local endTime 

set endTime to {current date) + length 
repeat while (current date) < endTime 
end repeat 
end I pause I 

□n flicker(cycles, delay) 
repeat cycles titnes 

tell appHcation '^rowerKoy Ejstcnslojr 

set level of outlet 6 of unit 1 to lt)0 - (level of 
outlet 6 of unit 1) 
end tell 
I pause](delay) 
end repeat 
end fl icher 

Calling the alx>vc scripi anikl look like the following: 
flicker(4H 1) 

iHlRD-PAKrY iNlTt^RAllON 

The PowerKey ha.s inspired some third party tools and 
integrates well with others. Acme rechnoiogies offers 
PowerGaLe, a CGI (Common GaLeway Interface) to the PK FrOj 
thereby allowing the PK Pro to be controlled securely from the 
web. Pacific Qjast Software also offers a Freeware AC(?il, 
SileMoniior, available at 

<http://www.pacific-coa5txorTi/st4>ages/Product_Dist/sitemcust.html> * 
Maxum Develc^pnienfs PageSeiitry is also an excellent fit 
with a PK Pro. PngeSentry checks to see if a web seiver if up by 
reqae,siing a page from tile .scjvct; upon an enrol; it notifies the 
administriitor. With the addition of a PowerKey Pro 6(XJ, 
PageSentiy can merely aaivate a PowerKey Script to restart the 
wcl) server. Ff WebSTAR (or whatever server you use) is set to 
launch at startup, the wel) server is back up and serving pages. 
Notice that this technique requires a Mac to handle die 
PowerKey, iiut the web server could be of any flavor: Mac, 
WinNT, UN7X, or BeOS. 
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RiiAL Uses 

'I'he PfwerKey has some very special uses. Offeririf^ a level 
of one iouch power conirol and scnptahility is a very 
enijxjwering aid and a blessing lor the differently ahled. (In fact, 
ids handy for tliose of ns with more powered peripherals tJian 
we might really neetU A i'owerKey Vro or ihrec and some 
diligcait scripting can allow the control of almost any electriml 
thing around someone with limited or nil mobility. Interesting 
uses can also include turning appliances on and off wiiii your 
cordless [ilione, a scri[>t, hot key, or even speech recognition, 
scheduling a computer's startups and shutdown, as well as 
leaving the monitor off until needetl. 

Even though I know of no one currently using a PowerKey 
Iho to do this, liaving a gicjup of routers controllable via a 
PowerKey Pro could allow routers to f>e power cyc^led so they 
can properly ping their seed router. Tlie [)ossiInlilies for creative 
System AdminisErdUon alxHuid. 

One Year Later 

Ids a bliz/ardy New England Sunday afternoon and our 
snowed-in, yet still inttepid Mac SysAdmin is snug at home 
surfing the “Net when the peaceful whine of the monitor‘s 
flyback tmnsformer is shattered by a dreaded pager vibrating off 
die desk. 1 lie [lager sliows an noiilication from the Soiaheastern 
region’s sales manager that the Elorida sales force's main 
datalxise is down during the weekend upload of sales figures, 
Ms. Manager wants it up rig!it away no matter that Mr 
SysAdmiiVs house can't see out of the H fcx)t drift and a 
snowplow is considered a mythical Ix^ast. 

He calls Ms, Manager and calmly assure.s her dial the 
database will Ix! up if there is [x>wer to die Mac and asks her to 
call right back \I the system isn’t up in ^ minutes. 

Our System Administrator has little to worry about —► his 
PowerKey I Vo 6(K) is ready. BQ 


Want to know what products 
are available for MacOS 
development? Check out 
Developer Depot^^ 
<http://www.devdepot.com> 


Guess which 
installer 
was built by 
Draginstall. 


‘n lillM Hi , M urn M Ml IM 1 M 1 IliStdllCT 


Show RtGtHTvnended bstitbtisjRS 








Cl 

^ .JL, 


St^tup 


Cl 

Svnpit low* 

Cl 


Works pace 



Tutorial f il#s 













7 \ 


m 

TI>f skk af !tw wihdkrw jhiiv£ Intilonklim, Tv ftvt, 

oiiv or tuor t- ti t lhM« ioMtt and dr .!) to aiiy desk Hi Utr riqhl j^id« 
ot tlw winflov. 

[ neod Me ] 

[ Wmt ] 




Guess again. 

If you guessed that the first installer was 
built by Draginstall, you're only half right. 
Now with Draginstall 3.0, you can build both 
of tliese installers from a single script file! 

For more information about Draginstall 
and a free demo, visit our web site at 

http://www.sauers.coni/draginstall 

or give us a call at 1-800-890-9880. 
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Solving The Eight Queens Problem 


Using the graphics of a 
Macintosh to explore the 
recursion and 
backtracking-based solution 
to this common puzzle 


One of llie oldest and riMxsi faiHiliar 
intellectual puzzler whose solution is 
uniquely suited to the computer is the eiglit 
queens probletiT in which the ^ 0 'a\ is In 
systeinatiailly determine each of tile 92 
different ways eif^ht queens can lie placed 
on a chess!XXIrtl without ctinflici. Of the 92 
solutions, 12 [nuinliens h 2, 5, 6, 7, 8, 9^ tO, 
1 h 14, 17 and 18] are unique; the remaining 
W are variations on the tw'elve — minor 
images on the vertical, horizontal or diag{>nal 
axes, or 90, 180 or 270 degree lotations. 

Since queens can move any number 
of squares in any direction, each queen 
must be placed on its own r(?vv, column 
and diagonals. Niklaiis Wirtli 11976, 19861 
describes it as a familiar problem and 
states that Gauss considered it as early as 
1850. No straiglitforw-ard matliematical 
ibrniLila has ever been devised for its 
solution. The tria band‘error jnclhcjd. 
often combined widi such |>rol)lem 
solving techniques as recursion and 
backtracking, while tedious and error 
prone for liuuian.s, is well-suited to the 


computer. (A computer doesn't get bored, make mistakes, or 
have a cat that jumps onto the chess board.) Each time Lite 
active queen is moved to a new position the new location is 
tested for conflict unless that position is off the board. In that 
case, we backtrack to the previous column or row, advance 
that previously secure queen, and proceed. Thus a backtrack 
involves a move without testing the new position for conflict. 
981 queen moves (876 position tests plus 105 backtracks) are 
re«|uired for the first sollUion alone. 16,704 moves (14,852 
tests and 1852 backtracks) arc needed Its find all 92 solutions. 
If we continue testing until all possibilities are exhausted, 
we've made 17,684 moves — 15,720 tests plus 1964 
backiracks. Given those figures, it’s easy to see why the 
solution is best left to ctmiputers. 

While text-oriented computers can t:leieimine the solutions 
as well as any, a graphically-oriented t'ompuier like the Mac is 
ideally suited for illuslrating the underlying algonthm. 

The widespread use of the personal computer as a teaching 
tool has contributed to the appearance of the eight queens 
problem in several tcxtixxiks in the past 20-plus years, including 
especially Wirth 11976, 19861 and Budd 11987, 1991, 19961. 
Niklaus Wirth’s solutions are in Pascal and Modiila-2. dimothy 
Budd has distussed object-oriented solutions, in languages 
ranging fnan SmallTalk to Object Pascal to Java, in at least three 
lx)oks. Microware furnishetl a structured BASIC version of 
Wirth's Pascal solution wirh their BASIC09 interpretei', which 
jjroijably received its widest disiribuiitm packaged for the Radio 
Shack Color C^ranputer 2 and 3. 

A web search on the phrase “eight queens'* will uncover 
several graphic java solutions, sonic interactive, based on a 
problem posed by Ikidd [1996]. For some reason witli my 
PowerPC Mac 6500/225 and Quadra 650, Micro.sofbs Internet 
Explorer browser works better in displaying the interactive Java 
versions on the web than does NetscafK^’s Navigator. 


FX. Kuechmann <ikJiaone.c(Jm> is a hardware designer, prugrammer anti consullanl with degrees IVtJni the University tif 
Illinois at Chicago and Clark College w^ho is currently building a programmers’ dock that gives the time in hexadedmaf 
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WiBU-KEY has been protecting software around the world 
since 1989. WIBU-KEY combines the most sophisticated 
encryption technology with the highest grade hardware 
components to give you peace of mind that your software 
won't be used illegally, You've worked hard to create your 
Mac application. Don't settle for anything less than the best 
copy protection system - WIBU-KEY. 


Hot plug 'n play ADB design 
Network support built-in 
Protect multiple applications 
or program modules 
Secure Remote Programming 


■ Consistent API for Mac and 
PC development 
User-friendly setup and 
diagnostic tools for your 
customer 


1617 St. Andrews Drive ♦ Lawrence, KS 66047 
Tel: 913^32-2070 * Fax: 913-832 8787 
j. Email: sales@grlft6ch,com 


8O0-9i6<eSIS 

www.grinech.com 


SYSTEMS 


TW Rueppurrer Strasa© 54 * 76137 Karlsruhe * Germany 
I Tel: -P49-721'931720 ♦ Fax: +49-721-9317222 
EfnaiL info@wibu.de 


Belgium, Lux. Compusec Tair -p 3 a-g- 64&0944 Fax: + 32 - 2-6464266 ■ Croatia Aries D.o.o. Tel: + 385 - 1-222752 Fax: + 3 S 5 - 1-2328538 » Eatonia Laneoft Ltd. Tel: + 372 - 2-444780 
Fax: + 372 - 2-682760 Japan Visual Mehrorks Co. Ltd.Tei: + 81 - 3 ^ 40-57801 Fax: + 81 - 3 - 340-57818 ■ Netherlanda Compusec Tel: + 31-53 8740223 Fax: + 31 - 53-5728822 


WIRI H’S Ai^RITHM 

Tlic queen eorifliet irackini^ mechanism employed hy Wirth 
coasists of three Boolean arrays that track queen status for each 
row and diagonal TRUE means no queen is on that row or 
diagonal: FALSE means a c|ueen is already there. 

Figure 1 shows the mapjoing of the arrays to die dicss 
board for Pascal. All array elements are initialised to TRUE. The 
Row airay clemenis l-S eorrespond [o rows 1-8 on the hoard. A 
queen in row n sets rows array element n to FALSE. 

Column-Row aitay elements are numliered from -7 to 7 and 
eorrespond to the difference lierween column and row numbers. 



Figure L Mapping the arrays to the chesshoard^ 


A cjueen at column 1, row 1 sets array element zero to FALSE. A 
queen at column 1, row 8 seLs array element -7 to FALSE. 

Tlie Coiumn+Row array elements are numliered 2-16 and 
correspond to the sum of the column and row. A queen placed 
in column 1, row i sets array element 2 to FALSE. A {|iieen 
placed in column 3, row 5 sets array element 8 to FALSE. 

Figures 2, S and 4 show the changes in array element 
values as 1, 2 and 3 queens are placed on the board. 

In Figure 2, Row anay element 1, Column-Row array 
element 0, and Column+Row array element 2 are all set to FALSE. 



Figure Z One conjlkt-free queen. 
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Oatuinn 



Cclumn- Fto* hpny 


Figure JL TiiK> conflict-free queem. 

In Figures, Row array element 3, Column-Row array dement 
~1, and Column+Row Array clemcnl 5 arc set also set FALSE. 


Thh Tkolibu; Wrni C 

In the C language, with its zerohased arrays, the mapping 
of the arrays to the hoar<i is a bit more eomplieaictl. Array 
elements are numbered On and die maf)ping of board positions 
to die arrays is comj>ensated accordingly, 'fhe Row array 
elements 07 correspond to rows 1 -8 on the board. A queen in 
row n sets Row array element n-1 to FALSE. Column-Row array 
elements are nuiiilicR'd from 0 to 14 and correspond to the 
difference between column and row numberSj plus 7. A queen 
at column 1, row 1 sets array element 7 Cbl+7^7) to FALSE. A 
c|ueen at column i, row 8 sets array element 0 (1-8+7=0) to 
FALSE. 'Hie Column+Row airay elements are numbered 0-14 and 
correspond lo the sum of the column and row, minus 2. A queen 
placed in column h row 1 sets array element 0 (1 + 1-2<I) to 
FALSE. A queen placed in column 3, row 5 sets array element 6 
(3+5-2-6) to FALSE. 




CoMnn 


1 3 3 4 5 « 7 e 



CoMmn - Row Array 



1 3 3 4 s d 7 a 

OD4uni> 


figure 4* Three conjlictfree queem. 


M\ny Ways to Tango 

Recurswe and non-recursive variations of Winh's method 
are easy to implemem on the Macintosli and other coniputei:s in 
most popular languages, including Pasc’al, C and structured 
BASIC, The major code dififerences l^eiween recursive and non¬ 
recursive variations are these: 

L live non-reeuraive version adds an H-eSement integer airay to 
hold the queen row for each column; with recursion lliis 
housekeeping is handled by the syslem. 

2* Tile recursive [>r<jgraiii's jiiain procedure uses a single for 
loop, with backtracking handled by the system, whereas the 
non-recursive version uses two nei;ted re|x:at lfK)ps and a 
separate procedure lo handle (lacktraeking. 


In figure 4, Row Array element 5, Column-Row array clement 
-2, and Coiumn+Row array eiaiieni 8 arc added to the FALSE list, 
It would require hundreds of pagej? to show the entire move 
sequence just for the first solution, whitrh is .shown in Figure 5 
All 981 moves can lie easily visualized by stepping through the 
program, either in single-step mexie or at slow speeti, while 
observing changes in the Boolejin array values displayed to die 
right of the lx>arcl, as cgieens are set and removed. 

Row* Krxl Down 


ColyiTtn 

12745678 



CQlamii ♦ fkm* 

Up 



Colunin 


With these exceptions, the code tor the iwo variations Is 
identical. 


In Pascal, the main Icxip of the recursive solution kxjks like iliis: 

proc^fidurft Try (column: intej^er): 
begin 

for row I Tn Pi do 
be^in 
t code I 

if colurai; < 8 then 

Trytcoluian + 1) I procedure calls itself I 
else 

PrintSolutloti: 

\ code J 

Eiid; I for I 

end; 


Tile core of die non-recursive soluiion: 

repeat 
repeat 
I code \ 
unLll row > ft; 
backtrack; 
until colmnn < 1: 


figure 5 The first soiutiofc 
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listing; 1. Try 


Listing 2b. RemoveQueen 


Rcm()v<.‘Qi«.*en 


Try 


Tlib pTtJccilun.- '& called with a colirnin value of I after initialij'mg the gftowc, 
^CoIHlu^Row and gi‘o!MinusRow Bot)lcan arrays itiTRl’R.When it finishes, all 92 
M^Iuiions hav'c been found. 


proCRflurr* Try (column: Integer): 
var 

row: integer: 

rDwFlag.plusFlag,minusFlag.: Boolean: 
begin 

for row 1 to 8 do 
begin 

rowFlag gRowcIrow]; 

pliieFlag := gColPluuRow[column + row]; 

mlnuuFlag gColHinusRowlcolumn - rowl: 


if rowFlag and piu^Flag and 

minufiFlag then 


begin 

gfiolnt ion Stash [column J row; 

SerOitcerL(row> column): 

11 column < 8 then 
TryCcolmnn + 1) 
else 

PrintSolution: 


RemovoQueen C row, r.ol umn): 
end: Mf kl 

end: (fori 

end; (Tty] 


Listing t .shows the complete TryO pmcetlure ft>r a 
simplified, nori'inieniciive version of the recursive solution. 'iTie 
tor loop repeatedly tests die lJ<K>lean arrays at indices consisting 
of the roWj sum of row and coiunin, and difference heiween row 
and column. The initial row^ and colunm values arc both L If 
these three Boolean tests are TRUE, a tjuecn is placed in the 
current column and row positions; if the column value is 8, we 
have a f|ueen in each column and print the solution. After 
priming, tlie t|ueen in column 8 is removed and the row 
increments at the top of die loop in pursuil of the next stiluiion. 

Otherwise when column < 8, the TryO procedure ltiMs iLself 
with an incremented column value and position testing starts 
anew at row' L If any of diree BcKilean array Ux:ations are FALSE, 
I he for loop row index increments and the tests rc|x:aicd. If ntw 
exceeds a value (^f 8 (that is, the active queen drops off tlie 
board), execution cctHtinues after the Try(colymn+l) line in the 
previous iteration of the procedure unless die column value 
ctjuals 1 when row exceeds 8. (In that case, all solutions have 
Ixicn found and operation passes back to whatever called Try 
initially.) 'Ihe queen at the mw fKisition for die current column 
is remewed, the row' increments at the top of die kx>(>, etc. 

listing 2a. SetQueen___ 

SctQuciii 

pto:^edtire SfitQuefin (row. coluBtii: integer); 
begin 

gRowc[row] false: 
gColiMusRowIcolunm + row] false; 
gColMinosRowIcolumn - row| false: 
end; 


procedure Reiaovenueen (row* column: integer); 
begin 

gRowe[rowl true; 
gColPltiSRow[coliufln + row] true; 
gMMlniJsRow[col Limn row] := true; 

end: 

listing 2 shows the SetQueen and Kemovet^ueen 
procedures dial update die R<K>lon arrays. 


Listing 3 a. Tty 


In' 


pfocodurc Try; 
var 

row. column: integer: 
rowFlag.plusFlag.mitiusFlag: Boolean: 
begin 

cow :* 1; 
column := 1: 
repeat 
repeat 

rowFlag gRowelrowj; 

plueFlag := gColPlusRow[column + cow]; 

minusFiag gColHinusRowIcoluron - row]; 

If rowFlag and plufiFlag and mlniinFlag then 
begin 

gSolutionStoab [column] row: 

SetQueentrow, column); 
if column < S then 
begin 

gRowForCoi[column1 row; 

row 1; 

Inc(column); 

Leave; 
end 
cine 
begin 

PrintSoiution: 

Remo veQu e en{r ow, column): 

Inc(row): 
end: 

end 

else 

loctrow); 
until row > R: 

if row > S then 

BakTraktrow* column): 

until cohimn < I; 
end; I procedure Try) 


Listiiig 3b. BakTrak __ 

Bokfrak 


procedure BakTrak (war row, coluiira: Integer): 
begin 
repeat 

Dec(column); 

If column > 0 than 
begin 

row := gRnwForCoucoluran] : 

RemoveOueen(row, column}; 

Inc Crow): 
end; 

until (row < 9) or (column < 1); 
end; 

Listing 3 gives the Try and BakTrak procedures for a non¬ 
recursive solution. The biggest differences fromIi5/i«^ / are the 
two nested rejicai kxjps the giobiil arniy gRowForCof which 
holds the row number of tlie queen in each coluirm. 
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Mac, go out and touch the world for 

ADB1/0 Sets ygLir oslomas^ Macs contrd things, il lets them 
ADB I/O lets the Mat: Ixi pari of Ihe physical wortd. 

Thousands of Uses 

SdencB, Multirixxiia, Chikiren^s Museums, Home Automation, 

Theatre Stages, IfHksIrial Testing, Mecfical Research, Bonsai 
Watering, Robotics, WcallKif Stations anything that can 
be electronically nrveasured or axitrolled can use Ihe ADB I/O. 

No Serial Ports Ocaipied 

ADB I/O uses the Apple Desktop Bus to mrrirTHJTw:aie inputs and 
outputs to and from your Macintosh (Maximum fxjlling frequency 
is 90 Hz.) No external power supply is rKxxJcxJ. 

Eight I/O Channels Provided 
Pour leiays for output. Four channefe for Digital In, 

Digital Out or 8 bit Analog In. 

Extensive Software Support 
With ADB I/O and nearly any environment," 
it is easy to build customized 
nppfiTiitiQrrs for your control and 
drila acquisition needs 
For mrye info, visit us at 
www.bxzi 


'lliese listinfts generate only the row numlx^r for the queen 
in each coltinin and do not show the eveiiT-handling t'alls or 
other fancifications needed to implement an inieraetive [>rt:^am 
with variable execution speeds, single-step mode, etc. For that, 
see iJstin^ 4 and llie full source ccxie files. 

Listing 4, DoColumns 

DoCulumiis 

1 oU Lfih piuccdurc l>t)C ijUiinrui indsirail of Try in urarr to distingubh It friim tlir 
corruspotKling pn>ccUuir in my'sadewavs* solmton, wbkh is ojllctf IXjRows. 

procedure DoColuttnit (column: Integer): 
vat 

roWpUHrotKum,rolSlxc: integer: 
roWiagtplusFlag,iiiiuusI^lag.Tni rFl jig,wbitp,DifigFlag* 
redDiagFlag,topBotFllpFlag*loftRtFlt pFlag, 
rotFlsg: boolean; 
elapsedTime.currentTise: longint: 
hn : byte: 
bogiu 

ggOol := column: 
tor tov := 1 to 8 do 
begin 

jupiUtc; active qiKcn ^M^sit^o^ unless in ijluti-lksil 
if not ggUfastFlag then 
begin 

DrawQueen(roWt column): 
if not ggVfastFlag then 
JpDateBoolcan: 

end: 

(test active queen for cofilllcts} 
rowFlag ggRowFiagsItov]: 

p]ij!?Flag ggColPlusRovlcolumn + row] ; 


iflinu^Flag :*• ggCoiffluusRovlCuluBin Raw] ; 
TTic(ggTeBtfl): 

UpdaicTc!?tCoimT; 

i put ihb hen* to iip^latr boolean di.vphy before fiaJiLng [ 

(in step uukJc if no TOnflirt ] 

if rowFlag and pluaFlag and mlnUfiFlng then 
begin 

SetQueenCrow. colunin): 
npDflteBooleen: 
end: 

if not ggUfasitFlag iben 
gBoardNoiCluar true: 

I flag used in ulTra-fast mmie lo ckar| 
jlxiard cuinpletdy 1st stdution after} 

|iiltni-bst mtnie h selected; onty | 

(those queens ilut tiave el tanged ]tos-| 

(Itlon are era.ml subsequently I 

if ggStepModeFlag true than 

ggStepFlag 1 =^ true 
else 

ggStepFlag false: 

If (not ggVfasTFlag) and (not ggbfastFiag} 

and (not ggStepHodeFiag) then 
[delay according to speed and model 
Stall(ggStallVal): 

{handle events except in vcrylasi or ultraTasi nuKtesI 
if {(not gglJfastFlag) and (not ggVfastFlag)J 

or ggStepHodeFlag thou 

begin 

repeat 

llandleEvenL: 

until (not ggStepFlagJ or ggDoneFlag: 
end: 
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Order directly from web site at www.neologicxom and save $100! 


Download the architectural overview or view it on-line with Adobe Acrobat 3,0 * - r- n 

The most powerful object-oriented database engine available 


kJ-»l 


M-FpAM to 5 P/W Pacific: 


MeoAccess'*^ displays electrifying performance—up to While others promise cross-platform - NeoAccess For information and Customer Service: 

ten times that of the competition. Behind its elegant delivers. NeoAccess is a set of C++ classes designed for 

programming interface is a fully optimized relational use with popular compilers and frameworks on Windows*, 

query engine built for speed. It also has an object cache Macintosh*, and Unix ' platforms. Thousands of deveiopers^ j 0-*^* 

with automatic garbage collection so your applications including America Online*' and Claris'*, have already nGO * lOgI C 

can run In a much smaller memory footprint than you found that NeoAccess enabled them to build fast, powerful NeoLogrc Sysiems, Inc. 

ever imagined possible. And NeoAccess has no runtime internet applications In record time. That's why there are . Sc, Suite 12. Berkeley CA 94710 

fees so you pay one affordable price no matter how many more NeoAccess based applications on end-user v. 510.524,5897 1 510.524,4501 

copies of your application you use or sell, machines than any other object database backend. neologic@neQloglc.cam 


If not ggStartClockFIflg then 
begin 

ggStartClockFlog r“ I rue; 
CetOateTiiee(ggStariTiBie) r 
If not gRujiFieg then 
begin 

GetDateTiine CggStartTotaiTiroe ); 
glunFlAg := true; 

end ■ 

end; 

if cowE'iag and plusFlag and minuuFlag then 
begin 

(aetivc queen positkm b ok, so save cowl 
ggRowStash IggSolNum, coiumn j row: 

ino solution yet; do next ccilumni 
if column < 8 then 
begin 

Inc (coiuinii); 
ggCol coluan; 

{proccduiv calls Ibclf] 

DoCoIttnms (column): 

if not ggOfastFlag then 
Sull(ggStanVal): 

Dec (column): 

(gg(]o| b used in tnfcnt-uiggcit.-d hoard redraws) 
ggCol coluinii; 

InctggBskTrak): 

OpDateBskTrax: 

if ggStepHodeFlflg = true then 
begin 

ggStepFlag := true: 
while ggStepFlag - true do 
HandieEvent: 

end 

else If HOT ggUfastFlag then 
Hr*ndleEvent: 


if column > U then 
begin 

if not ggUfastFlag then 
SnuffQueen(row. column): 

RemoveQiieentrow. column): 
end; 

end 

else 

begin 

Iwc have a cxndlici free quevn in each odumni 
jin ultra fast mode we iKcd lo uiHlaie the} 

(hoard and staibtks} 

if ggUfaslFlag rhen 

begin 

DoUfaetUpdute: 

UpDateBooleani 

UpdateTestCount: 

LfpdateBakTrax: 
fietDflr.eTime(currentTime); 

GlopsedTimn :* cnrrentTlme - 

ggStartTime: 

DrawElupsedfelupsodTIme); 
end: 

[get read)' lo test for unique sidution} 

TnitForHirrorsCrotFlag. whiteDiagFiag. 

redRi agFl^^g. topBotFlipFlag. leftRtFllpFlag. 
mlrF1ag. gMir rorNnm): 

{beeze time coiimeil 
ggStartClockFlag := false; 

I no board redraws} 
ggShowFlag :* true; 

TestForMir rors(gMirrorNum * rotNum,rotSize. 
iBT rFlag, vhi teDlagFiag* cedDiagFlag. 

!opBorFIipFlag* leftRtFlipFlag* rotFlag): 
ggShowFlag falne; 

if (not mirfiag) and (nor rotFlag) then 
begin 

ggUniqueSois [ggSolNuai] gUnlqucSolNiinii 
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Incl^UniqueSolKum]■ 
end; 

DrawSolxStatu^(mi cFlag.wTiJ leDiagFIagt 

ritrdniagFlag. LopBolFllpFlag*lefcRtFlipFlag, 
rotFlagt gJtirrorNujDt gUniqneSolNum. rotNiiait 
rotSia^): 

ggSolFlag TRUE; {:ivoid Ixjaitl ntdmw} 
if not ggWaitFlag then 
WaitEelaySeos 
else 
begin 

(wait run or step butioti push or quit} 

(set up and caU event liantllcr) 
ShovConiroiCggStepButtonHdl); 

HiiiteCont ro1IggStepButtonHdl* 0); 
ShowControl CggRunButtotiUdl); 
HiliteControl fggRunButtonFdi, O): 
SbovControl (ggSLepSulLoniltll) i 
HillLeControlTggStepBiittonHdl, 0): 

S G tC 0 nt roiTi11 g( g gKunEutt onHd1. 'Run *): 
ggStepModeFlag true; 
ggStepFlag true; 
repeat 

HandleEvent; 

until (not ggStepModeFlag) or 

(noi ggStepI'lag) or ggPoneFlag: 

(STEP button pushed in fast modes plus wail} 
f so drop to medium speed, step mode) 

if CggEfastFlag or ggVfastFlag) and 
{ggStepfSodoFl ag and 
{not ggStepFlag)) then 

begin 

ggUfaBtllag;= false; 
ggVfastFlag:^ false; 
ggSpeedHenuUdl:- 

GetMenuUandle(ggcSPEED MEHtI ID); 
ChGckIteai{ggSpeGdMGnuHdl. 

ggOldSpGod, 

ggcKLMOVE_CliFCK_MRK): 
CheckltGni [ggSpeedMenuHdi» 
ggcMEDIUM.ITEM, 
ggcADD_GHECK_MARK): 
ggOldSpeed ;= ggcMEDTUH TTEH; 
ggStallVal := geMedigm; 

Pnd; 

end: 

jin it the next soknioii] 
for n i to 3 do 
begin 

bn ggRowStash [ggSolHum* n] ; 
ggRowf5taah[ggSolNura -I- 1. n] bn; 
end: 

If not ggUfasiFlag then 
SnuffClueenfroWp column): 

Inc {ggSolNuin): 

DrawSolNum; 

GetEateTlme (ggStart.Tlinf!) ; 

ggStartd ockFlag true; (start the clock} 

clapsodTime 0; 

DrauElapsed CelapsedTlme); 

Removetiueentrow. column); 

EraseSoiStat: 

gTotalTests:=gTotalTests+ggTGflts: 
gT p ta1Moves:=gTo t a1Kov e s+ g gTc s t s+gg RakT rak; 
gTotfl1TestsSo1:^gTo taJ Tc sisSol+ggTest s; 
gKo V cs F 0 r So1:^gWu vesForSo1+ggB akT rak+ 

ggTests; 

FraseTestCount; 
ggTests := 0; 

UpdateTestCount; 

EraseBakTrax: 
ggBakTrak 0: 

UpDatefiakTrax: 

ErascTime; 

(allow board redraws) 
ggSolFlag FALSE: 

end; 
end 


el se 
begin 

if not ggUfaslFlag then 
SnuffQueen(rowj Column); 

end; 

if ggEoneFlag then 
Leave: 
end; {ftjr) 

end: {pmctxinrie DoCohimns) 

Listing 4 shows the recursive version of the Eight Queens 
program's main loop all dresseci up for the event<iriveo 
Macintosh party with speed and mode variations. 

Running the Program 

The Macintosh programs EightQueens I and EighiQueens 11 
have two operating inodes — run and single-step. At startup, die 
chessboard is drawn and a startup window is displayed for 30 
setx>nds or until the Go button is pushed. 

To die right of die chess board is an area giving die 
following information: 

• The lime to achieve each solution. 

• Tile solution numl^er 1-92. 

• 'Ihe solution status — unique or variation on a prior solution. 

• Tire number of position tests required to achieve each elution. 

• The number of backtracks. 

• 'I'he values of the elements of the Row or Column, Column 
plus How, and Column minus Row Boolean arniys used to 
determine the conflict status of the queens. 

Ad but the 2nd and 3rd are updated continuously as each 
solution prt>gresses. 

At lK)ttom right are the Run and Step buttons. In single-step 
mode, pushing the Step button single-steps the currentJy-aaive 
queen. Pushing the Run buttcin causes. Push the Step button to 
rc-selet:t single-step mode. 

The program operates initially in single-step mode in 
which the active queen steps when the Step button is pressed. 
If the Run button is pres.seth run mode is entered; die Step 
button disappears, the Run button is rc-labcled Step, and the 
active queen steps continuously until a solution is achieved. It 
then delays (default delay is 10 seconds) before stepping to rhe 
next solution unless Wait is selected from the Delay menu. 
Both the step rate and the duration of the delay can be varied 
via the Speed and Delay menu. Speeds vary from about 1 step 
per second at the slow end to liiindreds per seamd. Default 
speed is about 4 siejis per second on a PowerPC Mac 6500/225. 
The delay lietween solutions can be varied from none to 30 
seconds in 5-seeond increments, or Wait can lie selected and 
the program will enter single-step mode after each solution. 
The Step button changes to Next, and the program waits for a 
click on the Run or Next button. 

To determine w^hether a .solution is unique or a variation on 
one of the twelve unique solutions, the program creates seven 
variations of each solution to compare with the previous ones. 
The variations are — left-toright flip (vertical axis mirror), top- 
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ro-hottoni flip (liorizuntal axis mirror), uppcr-lcfl-UJ-lowt^r-right 
(reel) diiigonal mirror, [ower-left-to-upper-nght(white) diagonal 
mirror, and 90 degree, ISO degree and 270 degree clockwise 
roiatioos. To view these in sec|uenee, click the Next button. The 
variations will amtinue to be displayed in sequence as lung as 
the Next button is clicked, 

If you click the Run button, the Next button Ls relabeled 
Step, and the solution status line tells whether the stjiutiun is 
iiniqtre or variant. When the status line says, for exam[ile, at 
st>lution ^12, Rotate 90 deg CW #10, it means Totaring solution 
^12 90 degrees clockwise gets solution ^10”- at solution *2\ “Tx:fi 
Right Flip #11" means that, if solution #21 is Hipped left-io-righl, 
we gel sokHiun #11. At #t3 , ''Red diag mir #8" means that if 
solution #13 is ilipt)ed on the red (upper-left-to-lower-right) 
diagonal axis, we get solutitm #H. Solution #16 is a white (lowcr- 
IcfL-to-upper-right) diagonal axis mirror of solution #8. Solution 
#73 is a top-to-bottom flij^ of #18, etc. 

Clicking the Run button again steps the active t|ucen 
continuously at the previous speed to the next solution, wdiile 
clicking Step single-steps the active t|ueen and sets the speed 
ro Medium. 

When tlie program ceases pursy big solutions either because 
all [icxssibilities have been exhausted or bet:au.se Quit li:is been 
selected from the File menu (or Command-Q fnmi the keyboard), 

I he area to the right of the board clears and displays statistics on 
the nuitilier of solutions achieved, number of positkm tests and 
backtracks, etc, Tlie riglu buUon appe^ars, labeled Stop, while the 
left button is labeled Run. The user can then clioose to either 
resume seeking solutions .staiting at die begmning by clicking 
Run. or terminate oj>eraLion by clicking Stop. 

SOLIRCECODE 

Sourcecode for two variations of WiitITs algorithm for 
solving the eight queens problem is supplied for CodeWanior 
Professional Pascal, lliose readers familiar vvitli Dave Mark's 
Ixjoks may notk e some resemblances lierw^een the eight queens 
.sourcecode and some of that hmnd in Oave s hooks — things 
like some of the names of constants and general structurc of the 
cvenl kKip. Tlie resemblance isn't accidental. 1 used the Timer 
project from die Macmiosh Pmcal Primer^ Vol. 1, 

by Dave Mark and Cartwright Reed, as a “skeleton" for 
PightQueens, While most of the code is mine, undenieath there’s 
still a l>it of Mark and Reed code holding things together. 

Variations 

Wirth's recursive algoritlini used in EiglitQueeiis I indexes 
rows ill the single for loo[) and columns via recursion, bur the 
method works equally well if the rows and columns are 
switched. The movement of the queens is then from left-toright, 
starling at the lof) row. We gel [he sitme 92 solutions, hut in a 
different order. The first solution with horizontal queen 
movemeni is the same as the fourth with vertical movement. 
Each .solution, however, takes die same number of tests and 
backtracks as with Wirtli's aigoritlim — B7h tests and 103 
backtracks for the hrst solution, 264 tests and 33 backtracks for 


the second, 200 tests and 25 backtracks for the third, etc. The 
reason Ix^comes obvious if you think alK)Ut it. Take the board set 
for veitieal queen movement, witli a single cjueen upper left. Flip 
the board on the vertical axis so the queen is in the uppGV right 
comer, then rotate it 90 degrees counter-clockwise to put the 
queen upper left. Start .successive cjueens in column one, 
incrementmg lefi-to-right. Test queen.s have exactly the same 
p(xsiiions relative to ihe first queen as in Wirth's original 
UfqM’oach, EighlQueem II shows this “sideways” approach 
implemented non-recursively using two nested repeat loops. 
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BECIIUMER'S 

CORNER 


by Peter N. f.eiins, Perth, A ustralia 


Using AssertO 


Understanding 
assertions and how and 
when to use them 


Introduction 

JV!:my prognimmers hclicvt; ii is 
impfxssible U) wriiu f>ug free They 

jasi iisfiomc liugs are a part of life and that 
Ix'Ui testers and QA eJepartments (or even 
end users!) will I'ind and report the bugs 
which will ihen (hopefully) lx tracked 
down and resolved, I'm not sure I believe 
it is possible to write bug free code, bm 
one thing 1 certainly Ijclicve is that it will 
not hapjXTi without a conscious effort on 
the pan of ilie programmer. 

Once you have detaded that writing 
bug free code is a worthwhile goal, the 
first and most linpcmam tool at ytair 
disposal is the “Assertion'’. An assertion is 
simply a piece of code that validates part 
of ihe stale of your program, and alerts 
you if something is wrong. This article 
descrilxs assertions, why you vvanl to use 
them, wliat they are, when anti where to 
use them, and how you implement them. 
Throughout this article 1 wall use examples 
in Pascal ov C, hut the concepts apply to 
almcist any language. 


• If you deteci ii during syntax check, compile, or link, it takes 
only a few seconds. 

• If you detect it as soon as the program laundics, it takes 
only a minute. 

• If you detect it in your own testing, you probably will not 
waste much lime, especially if an assertion fires to tell you 
exactly wTai went wrong, 

• If you sentl it to your Ixla tcsteis/QA department, you are 
wasting days (and other people's time), 

• If you ship it and your end u.sers find the bugs, the results can 
he arbitrarily liad. (Imagine your coiiipatty going out of 
busines,s l>ccaLise of bad review^s of your buggy product!) 

Assertions make it easier to delect [>ugs earlier. By 
automatically detecting bugs you can find them before the bug 
has a tthance io cascade and destroy the evidence. The more 
lilxTally you use usseitiorLS, the more t|itickly you will find bugs. 
And Ixcause assertions am be “ccjiupiled out'* t>f your code (I'll 
show you how to do this in C and Pasail later), a.ssertions only 
slow d()wn your l^eta versions so yf>u are fme to use lots of them. 

WiL\T IS AN Assertion? 

At Its most basic form, an a.ssertion is simply a procedure 
that takes a lxx>lean parameter and reports (to the programmer) 
if the Ixxrlean is false, for example: 

procedure Asetirit muei: boolean ): 
begin 

if not must then begin 

DebugStr( 'Assertion tailed sac* ): 
end: 
end i 


Why You SHOtmD Use Assertions 
Bugs come in many shapes and sizes, 
hut there is a general rule of thumb that 
the earlier you deteci a hug the less time it 
takes to fix it: 

* If you delect it a.s you arc typing, it 
lakes frasic'ally no time. 


You can report the coor using any method you like 
(DebugStr, Alert, writeln/printf, etc), atid can include any extra 
infonnation you want (such a.s the source file ami line or a text 
message explaining what happened). 1 generally use DebugStr 
since it will work even in inten’Upt level code, but it does ix.*quire 
you install MacsBug or some other low level debugger. Also, 
since the .Meirowerks l)cl>uggcr can catch DebugStr and leave 
you ptiiniing at exadly die place where the assertion tailed (once 


PetcT N. Lewis Ls a successhii shaieware autlii>r. He ft>iindc<! Stairways St>ltw'are Ply i.td in 1995 and specializes in Macininsh 
TCP/IP prtKiucis blit has lx‘cn krumTi lo tiiveniiiy inri> oflier areas. 
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you .Step out of the Asstri function), there is nr> need to inelude 
an explanatory message. 

it is important to note that assertions are not a form of error 
checking. Assertions exi.st to detect programatieal errors, tliey are 
not LLseful for detecting real life error conditions like clisk or 
network errors — errors sucli as iherse must be deleeted, handled 
and reported by errcjr ehecking cixle iliai remains in the sliipping 
version and that rejKjn.s t (7 the user in a helpful manner. 
Assertions are to help you as the progranmier, your users should 
never see tlieni if you do your job property. 

When and Where lo Use Assertions 
The slum answer is to use assenions everywliere. Anywiiere 
yon are using facts about your programs stale that are not 
ol jvious from the pnx:ecding lines of code, you should consider 
using an assertion to eonfinn tliat the "facts'' really are true. The 
most imfx>narU places are: 

• At tile Stan of each procedure (check lluti tlie parameters 
are acceptable). 

• At the start of each loop (cheek that the ioop invariants 
lujid true). 

• At tile end of each l(x>p (cheek ihai the liK>p has done its job). 

• At the end of eaiTi procedure (cheek that flic piocedure ha.s 
d<me its job). 


* Before using any pointer (check tliai the pointer is not nil). 

• Before using any sinuTua" (check that the .structure is validX 

Fur example, say we want lo write a routine that accepts 
two .string pointers, sourc6 and dest, wliere the source Ls suppose 
to lie an 8 ciiaracter string of lowercase letters, and its job i.s to 
uppercase ihe string and store* it in dest, With assertions added, 
we might write il like this: 

procedure UppfirciJSL’( ^gurce: StrlngPlr: dest: Strin^Ptr ): 
const 

rpqil *-i?d_length S: 
va r 

i: Integer: 
begin 

Assert E (source <> nil) & E length (source'') “ 
required length) ); 

Assert ( desi <> nil ); // kk*silfy wt* wniiUI like to ic.st that 

// is lon^ rmiiigli 

AssprtE source dest ): // klcally wc wuuld like to tcsi that they 
// do not overlap 

dcst^lOj chr [requi re<l_length): 
for i 1 to rpquirod^iength do begin 

Assert E Bcufrce''[il In ): 

dest''[l) 1“ UpCaseE source''[iI ); 
end; 

As.^en ( KqiiaiStringE dest'^, false, true ) 

end; 

So, we start off checking the preconditioiis (dial source is 
not nil and is ihe right length and dial dest is not nil). We shoulci 
really also check lhal source is made it[) tmtirely of lowerca,se 
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letters, but we defer that to ihc loop w^here it is easier to check. 
And ilien ill the end we clieck that we have done the job - it is 
a pretty loose test, (checking only that dest is case insensitively 
equal to source), but ie at least checks that we Imvc done 
someiliing like what we said we would do. 

We also assert that source must not be the same as dest — 
it would be easy enough to ensure that the code worked 
properly in this case^ but f don’t feel like che<*king the code for 
that case so instead 1 save myself some work and simply 
disallow it - if ai some future time a programmer tries to use 
this rouline with that c^ase tlicy will immediately get an 
assertion, they can then cither fix their code to use two strings, 
or update Uppercase to ensure this cixle works properly in the 
case where source and desl are the same. 

ThLs is another use for asseitioas, they arc a form of self 
dcKumenting code. If I simply added a comment to the 
documentation tliat source and dest arc not allowed to overlap, 
a programmer might not notice and might accidentally use the 
procedure in this manner. Worse, the cckIc might work 
sometimes but not always. It is miK:h Ijetter to enforce liie 
restriction In tlic code so that a any future user of this routine 
immecliaicly Icams of their misiakc. 

CowpiuiK Generatfd Assertions and Warnings 

It is worth noting that the c’ompiler is capable of generating 
some assertions of its own, and you should take advantage of 
these whenever po.ssiblc. Take the time to go through the 
compiler settings and ensure all possible warnings ami checLs 
are enabled. For example, the compiler may have range 
checking or nil checking options. It iruty also l)e able to detect 
things like unused variables, variables used Ix^fore they are 
initialised and functions that do not return resulcs. These 
warnings and errois can save you a lot of time so turn them on! 

Duplicate your code and check your data structures 

In the example above, we c hecked at the end of the routine 
that dest was case insensitively equal to source. We can actually 
go further and check Uial dest is exactly what it should lx* by 
duplicating the routine, something like this: 

var 

i: integer: 

IStfc do_debugl 

test string; StrZ 55 : 

[Sendcl 

begin 

tSlfc dg_d^bug| 

test_string source'': 
llpperStringC tesl_atring, false 1 : 

Asaert{ dest'' = tesi^ntring j: 

($cndcI 
end: 

Now when tills routine executes we don't have to wonder if 
it is doing the right thing and hope that we spot the problem if 
it isn't. We know^ it works correctly every lime Imause if it ever 
fails it will immediately notily us of ilie problem. 


Note how the debugging variable tesLstrfng is compiled out 
if do_debLig is false, lliis is for two reast)ns, fir.si ii avoids the 
unused variable warning when you bLiild the non-debugging 
version, but more importantly it makes it clear that tesLstring is 
for delxigging pLiqKJses only and ensures it i,s not accidentally 
used in the ""real" code. 

Many programs have a single important job that iliey 
perform. For example, in a tlrawing program it might be 
rendering to the screen, in a spreadsheet it might !>e the 
recalculation engine, in a game it might be updating the game 
slate. These all involve taking some input state and mapping it 
to a new suite. You can use assertions to validate your code In 
two impe^rtant ways: 

• iiy checking that the state is valid before and after the update, 

• By duplicating the engine and mnning Ixith and ensuring 
they get the same results. 

Checking die state Ls generally pretty^ easy, you just go 
through c'ach variable in each struciure and en.sure thiii it is within 
actxrpiable ranges. For each intentetion, you ensure the variables 
are compatible. For example in a drawing package, you might 
assert that each olijea is within range, that each rcctangle has tour 
(xiints, that each colour or [jatteni is valid, that each gmiip is 
made up of objeas that arc inside the grciup, and so forth. 

Duplicating the code engine can lie a fair amounl of work, 
but it can also lx? very valualtle. Often these engines must be 
very effit ient so they end up being higlily optimised. At the start 
of die project, you might write a very simj)le engine as a proof 
of concept - raiher titan throw this engine away, keep it and 
execute it in parallel with the new optimisetl engine you write 
and then check that ihe results are identical. For example, in a 
tirawing package, you might do something like this: 

JJr<^c^?r^ure UpdateOf fac rftfinWorld f offifcrocn: RWorldFir ): 

¥ar 

tgfi: RgnHandle; 

I Site dg^debiigi 

debu^world; G^oridPtr: 
l$€[idc) 
begin 

f i ndCbangeRegion( rgn ); 

RedrawOnlyChangtJS( offscreen, rgn 3; 

DispofieRguC tgn }; 

I$ifc do_ctfibugl 

HakeNtfiirOffscreenHoridt debug^world ); 

DrawEveryilrtngt debug_world ); 

Assertt Idem icjil Bits ( Oti^creeri, debugs fid } 3 ; 
tSendet 
end; 

How TO Implement Assertions 
As dcscrilied above, the basic assertion is simply a 
proc:edure that takes a boolean and report,s if the boolean is false. 
However, sitice ctiniputing the a.ssertion condition may lx* 
computationally exfxnsive and .since it does not in any way 
affect fhe execution of the prtigram, it is desiral)ie to have them 
automatically removed from your code Ixforc you ship llie final 


30 


Using AssertO 


MA<TEt.H • Dkchmher 1997 










verston. To do this, we couipiler imcfos {^dcTmc rn C, 
ISdcfmec) in Pascal) like ihis^ 

tflfiidef da_debug 
#dt?fine do_debtjg I 
#endif 

#if Ido dfibug 
^define AssertCb) 
i/else 

Sdofint' Assort{b) AsucriCodetb) 

^oridlf 

#ii do^debug 

void AssertCodet boolean b h 
#endif 

Or 

ISifr not defined do debngj 
t$f:etc do^debuft II 
iSonde I 

ISife not do debugl 
ISdefinee AHserL(b)) 
tSelsecI 

iSdefinoe AssertCb) AssertCodetb)I 
I$endc] 

ISifc do_rfebug) 

procedute AssortCode {b: boolean)r 
I$endcI 

First, we deiiiLilt do^debug rme. llien wc define the 
macro, mapping As.sert( condition ) tt) either nothing at all or to 
a call to AssertCodc — ihe actual procedure is renamed to 
AssenCotie so that it’s definition is not mangled liy the Assen 
macro. For final builds you can use a prefix file to set do^debug 
lo false and tlieji recompile all your source. 

There are two things you have to l>e careful with. First, since 
the macro mechanism effectively removes the Assert lines from 
your program, you must never use a fimaion with a side effect 
in your assertion. For example, you miglil be tempted to do 
something like thLs: 

Assert ( NcwGWorldt « ) -* noEci: ); 

However, when you compile that with do_dehug set to 
false, the line will disappear and the GWorld will not lie created. 
Instead you should write: 

<)rr = NewGWorld ( * ); 

Assert ( err nolirr ); 

For this reason, and just for general safety, it is import dial 
you set do_debiig to false for at least your last few beta builds 
(after you have resolved all bugs that cause asseitions to fire of 
course!) so that you can gel some serious testing with a build tliat 
is ahiiosi identical to the final build. 

Extending Assertions 

Assertions can lx? as simple or as complicated as you choose 
to make them. I have descrilxid a very simple implementation, 
but you can expand on die conccfit in several ways. 

You could use a more interesting rejxming mechanism than 
simple DcbugSirs such as Alerts or sending the repons out a 
serial or TCP connection. You could build on what you want to 


assert, such as asserting dial a pr:)inter or fde reference or TCP 
stream is valid. You could also add information to the assertion 
such as the file name <jr line number or a message describing the 
cause of the assertion. 

Always keep in mind that you want to use assertions 
frequently in all your ctxle so there may be some constraints 
on what you am do in die Assert routine if you are WTiting any 
low level code like interrupt routines or drivers, and you 
.should avoid making the act of including an assertion overly 
tedious (that is why I generally doiiT include an explanatory 
message in my assertions). 

You can also look around for other aSsSenion libraries 
— CodeWarrioris MSL and PowcrPlant both include 
support for assertions. 

rX)Nf:i.llSION 

The single most important question to ask yourself whenever 
you find a l>Lig in your code Is “How^ could t have prevented tliis 
bug?” or at die very least '"Ilow a>uld f have found this bug 
earlier?" Assertions are one way of finding bugs very early. Steve 
Maguire's exceUent book, Wrilin^ Solid Code, dcs4:ribes assertions 
and many other ways of finding m preventing bugs (including 
stepping thiougb any new code you write, writing g(K>d 
interfaces, choosing safe/debugable implcincniations). 

These techniques really do work. They wil! save you time 
and frustration, and they w^ill dramaiiailly increase the level of 
confidence you have in your code. Where you would previously 
itavc siiid "this routine finiliably does more or lcs.s what I expect" 
you can say with conhdeiiec that it does exactly wfiat it Is 
suppose to do, and if it ever tails, you’ll hear about it immediately. 

So if you are going to write code {es|x?cially if it will end up 
running on my Mac!) go and read Writing Solid Code, gel an 
attitude adju.sLmcnt, and start writing l)ug free code! 

Reierlncies 

• Writing Solid Code by Sieve Maguire. This book is the 
definitive reference in my opinion. 1 believe all 
programmers sliould read this book, it does a great job at 
explaining this topic and at motivating the reader to strive 
to write liug-free code. 

• Fffectiw C++ by Scott Meyers. C++ has many ways to intioducc 
bugs in to your code tliat are very diftlculi to debug. F:fTective 
C++ descrilx:s many of these and liow to avoid them. 
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by Edward Ringel 


StoneTable 


This List Manager 
replacement offers 
many advantages to the 
Mac OS developer 


Thu visual manaj^eiiicnt of list and 
tabular data is one of the weak points 
the Mac OS Toolbox. Although each 
programmer may have his or her pet 
peeve about the list Managei-j most 
developers would agree on three 
substantial limitations. Hrsi, and I think 
toremosi, is the 32K data limitation. 
Altliough it is possible to write an LI3TF to 
overcome this limitation without loo much 
ditiiculry, wuYe still left with the fixed ceil 
size and absence of c eil stylCvS. Granted, for 
stmte applications, the List Manager 
routine.s may be more than enough, On 
the other hand, for anyone with the need 
to manipulate larger amounts of data, or 
with the need to customize rows, columns, 
and cells, it can be pretty easy to bump up 
against die limitations of the List Manager. 

After seeing StoneTable advertised 
repeatedly in MaeTech and l(K>kiiig at their 
demos, 1 diought it might lx* of interest to 
tile Mac programming commimiiy to 
explore this product in depth, as it is the 
only tal least to my knowledge) 
freestanding commercial List Manager 
available to ilie Mac prograinming 
communily, Sioneiable is a [xjwerful List 
Manager replacemeni that offers many 


improvemenLs over the list Manager routines. Its current 
competition lies primarily in some of the components of 
frameworks and one piece of almost freeware that we’ll mention 
l)riefly at the end of the anicle. 

Package Contents 

I received StoneTable via the Iniemet, w'hich is c urrently the 
normal mc*ans of distribution. 'Hie archive was aix)ut 1 meg. 
Alter clet^ompressing the package, I reviewed several different 
dcxiiments and files. Tliere is the usual rc'acl me alx>ui bugs and 
Ux like, lliis dcximient, addressing version 3 , indicated that 
there were no known [>ijgs. There w-as a longer document 
reviewing the changes betw'een version 2 and version 3 - 
Although there was a host of infonnalion there aiK>ut the 
differences between verslon.s, there was no band-holding about 
liow to do the conversion. 

Tile primary desc rifiiiun of the product is an Acrolrat file 
which is a model Ft ir software package ckxumentation. It is dear, 
concise, and well written. The introduction and general 
pfint'ipies of Ojxration are very helpful in setting the **gn)und 
niles** for the package. Tlie function nomenclature is uniform, as 
aR‘ function desciiptioas. 1lie dtxument makes nice use of 
hypertc^xi t:n)ss Rferencing. I woulcl have liked to see snipf>ets 
of example code in the function descTipLions, hut 1 could also see 
that as excessively burdensome for the author given that he 
provided a sample program as w'elL 

The sofuvare itself consists of a .ii file, a .p file, (ilmaries, 
procedural code examples, I'DHF developmcni instructions 
(covered below) and a Pf>werPbnt class and sample app 
based on Stone'I’able. The package I received had 
CodeWarrior files for 6 HK application and code resource (A4) 
clevelopmem as well as a I^PC lil>. The sample programs and 
projects work under the new CodeWarrior Pro IDE. The 
sample [xogram is fairly simple and dex\s not show off every 
last feature of StoneTable. However, careful review of the 
ctxie definitely will show the programmer how to get started 
and use ilie library effectively. 


Ed Rtngei <erin>'el^mint.net> i.s C(j[^trihuting Editor fur product reviow^i friT MacTech Maga/ine. In his spare rime, he is a 
respiratory and critical care physician in Wuierc^iile, Maine. 
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Lois Morl Thais tih- List MA^ AGER 

Stone^lable perfomis muny, many useful tasks. Obviously, ii 
does everything that the List Mamiger does. Ihe additional 
functionality is wliy people pay mtiney for this product. 
StoneTable supports tables of data that are greater than 52K in 
aggregate size. It allows many different cell data types, 'rexi, 
chceklxjx, popup menu, PlCTs, icons (all sizes), hierarchical lists, 
and CDCF controls are all suj)portcd. A wide variety of style 
infbriruuion can be attached to each cell: justifications, font, size, 
margins, anti foreground and background colors are all options. 
If necessary, Uie progratnnicr can write a TDHP \o suppon a 
custom drawing procedure. TDEF’s are Tal>le DEFinitions 
suppf^rted by Stone lable. A prototype sample '[*DEF is provided 
as part of the package. 

Text entry into tables is quite sophisticated. One of tiie very 
nice features of StoneTable is iii-cell editing, which for some 
prognimmers is the holy grail of lists. Ceil data entry validation 
hooks and stubs, as well as built-in validations for niiml>ers, help 
insure data accuracy. Sort and find functions are provided, 
("omprehensive control over list appearance and behavior can be 
achieved with TI)FF\s and other hooks, stubs, and callliacks 
provided by the library for llie |)rograinnier Many of tlic 
appearance services are provided in such a manner so tliat the 
end user of the application can easily control list api^earance 
wiili a mininium of programining on llte pan of the developer. 

I’here are a host of other very Lisefiil services y)rovided. 
Drag and drop and clipboard management, while not tenibly 
difficult to wTire, are a nuisance, tedious, and error-prone 
routines. These two services require airntjst no [programruing to 
implement. Drag and drop services in particular me quite 
sophisticated and include transfers to and from Stonel'able and 
noii-SlDneTai>lc applications in either direction. Clipboard 
information includes all cell data. 

lJsiN<; St()neTari.f 

The jjrogrammer must first cTcatc a SUmcTahle list, and llien 
intercept events directed at the list and allow the StoneTable 
library^ to process the event. Table creation is not awful, l.iut 
requires multiple function calls to set display and interface 
options completely, 'rhis is the kind of situation that could lend 
iLself nic:ely to a resource that is created by the programmer and 
then passed to a single MakeTable() call. 

'lb intercept table events, StoneTable requires some 
iTKxlification of the basic event loop, but overall this is not an 
tmcTous task. Because many unique services are provided, the 
program must give the Stone1’al)le library the opportLenity to 
intercept events that are directed at a StoneTable list. This is done 
by intercepting various mouse clicks and keyboard events, as 
well as activate/deactivate events, etc. I have lifted, with scjme 
modification, the conceptual outline of talile creation and a 
lypica! procedural event loop from the manual (my apologies to 
Bill StackJiouse for any corruption nr obfuscatiesn.j 


//The general (iiuMne <^f sn applitiiihjn that uses Smfietlible. 
j'hnclude <StaneTi5b1e.h> 

create_table() \ 

window “ MewWindow t.,.) : 

n e w_ T .1 h 1 e - TMX w [ ; 

//Cnrate a new table anti a ttach it to a window, then set the various i^ptions 
TMX_SoLOpLlon!i{...); 

TfDLSetCrldUh 
THX_SetCoiumnTitleText («J t 
TKX_S€tKowTltleText{.«) : 

//N<)w set the cell data 

TMX S^.tCfi]]TexrU): 

//Now draw the list 

TMX_i}oDraw{...) ; /* set dniwlt to TRUE 7 

) 

//event Itjop 

procoss_(iV!»nt.{r!VC’nt} I 
Rwitcb (evnnt.whaTl I 
etiiie tiullEvont: 

//Take tr^re of tabic idle cvent.s along with p^granr idle events 
TMX„Idie(„.): 

TMX_WhatCt 3 csor(.«); 

TMX Hhere(...): 

mouScDown: 

//'Fake care of table mouse down events along with program mousL^ down events 
TKX^Clickt...) ; 

case updateEvtt 
//Pn)eess update evenLs 

TMX_Upd3Tn (...); 

cane acLlvateKvL: 

//Process activate events 

TMX„Activate(.J : 

cane keyDown; 

cflsp nutoKcy: 

//proecs.'i table key evemts and simultaneoustv hands off non-table twents to the pnpgram 
iX [ 1 TMX_KcyNav (...)) 

I 

I 

StoneTable, like the List Manager, imkes the programmer do 
a lot of work to fill the list. StoneTable does provide one function 
ihai will take Lab delimited lexi ckta and load cells en mas.se, bur 
oriier kinds of data must be loaded ceil by cell. At first, 1 dioughi 
this was a considenible failing of the product, but as I tlioughi 
aboui El tiiore, I realized thai it woukl lie quite difficult to automate 
loading cell data. Similarly, saving a table to a file would rct|uire a 
custom function written by die programmer. This discussion ain't 
help hut niise the issue of transferring data back and forth between 
a program riiemory stmeture in wliicli the data is manipulated to 
a StoneTable structure in which the data is displayed. Widi correct 
programming technique, 1 do not think it would be necessary; 
StoneTable t:c>iild keep il all without tex) much difficulty. These 
])ros and cons notwidistanding, it still might lx.‘ advantageous to 
able to store a Stonelable "‘persistent object,” and this might be 
a future goal of StoneTable iipgracles. 

In general, StoneTable calls are mcxleled after the List Manager 
calls, so the tmnsition is at least somewhat intuitive. Additionally, 
the StoneTable PowerPiant object is modeled after the LTabie class, 
also simplifying die transition as much as possible. 
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Memory Issues 

Memory needs huve liie ix)tenttal to hz sul>,stanfi:»l. Each 
row and eaeh coJunin, requires atout 24 bytes alkxnied, Kru(>iy 
cells rake no memory. Those that have data arc stored in a tree 
siruciure for quick access. Each allocated cell uses a minimum of 
about 46 bytes w4iich includes style information for that cell. Tliis 
uses more memory, but apparently is faster tJian having the style 
allocated only if different from the default. Memory is allocated 
using a memory manager that sirs on top of the Mac Tcx>lhox 
Memory Manager. This internal memor)- manager allocates 
memory from large handles. Titles other than default letters and 
numlxns are treated as a regular cell. 

Nunil^rs and text are both stored as text as in the List 
Manager. If necessary, the programmer can store binary data in 
die cell. Apparently, there have Ix^en no complaints to 
iiloneTable about performance due to numeric tkita. 

TiiE FitsisiiED Product 

Judging from the available demo program and the sample 
program, iCs not too difficult to create a very handsome table 
that is very responsive to user actions, i ran tlic sample program 
in 68K mode on my trusty Per forma 6200 as well as PS^C mode. 
The 68K mode was adequate, and the PPC program was 
downright snappy. Given the numlier of lines of .sample code, 
the control over the lisps appearance and the quality of the user 
interface is very impressive. 


purcha.se StoneTabie for a complex list problem, both Ttxjls Plus 
and AppMaker arc^ "StoneTable aware" which makes it much 
easier to use tliis produa in those environments, 1 think it would 
lx? almost foolhardy to cremate a I.ist Manager repiaccineni from 
scratch if you were pn )gramiuing in suaiglii C, Pastaf or C++ 
witliout using a fmmework; Stone'lable would 1+e a logical choice. 

All in all, StoneTable is a solid, useful tool for table 
management. Many prognimmers will not use its full array of 
functions. Stonelable tables in an application will be well 
behaved and easy to implement. Some framework programmers 
may be content to use the native" table object, but many 
framework developers may still benefit from using Stonelable^s 
unique features. In particulai; in light of the recent price 
decrease and version increment, Stone!aide may warrant 
careful evaluation. We would be most foriunaie if all ‘^niclie'* 
products were this gex^d. 

Products Rhv jew ei> 

StoneTable, version 3.0 $199. Available from Developer 
Depot and directly from the publisher. Stone fable Publishing, 
P.O. Box 12665, Portland, OR 97212. (503) 287-3424. 

usEi UL mrs 

StoneTal^Iet publishing lia.s a web site, ftp site, and email 
addre.ss, When you purchase the product, you can join a list to 
he notified of updates, issues, etc. 
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The Competition and the Bottom Line 

Although I itave not made an exhaustive search of the 
[produces out there, 1 don! know of any cunent, commercial, free 
standing List Manager Replacement except StoneTable. !’htTc‘ is 
an interesting procltici c^jtlled the A list, wltich i.s almost free. It 
has many gcxxl features, but dex^s not have the speed or full 
feature set of StoneTable, JTom a commercial standpoint, it is not 
bug free and is not supported in the same manner a.s StoneTable. 
In paniciular, I found the code in lie mucli slower than 
StoneTable, which would a serious issue with big lists. 

PowerPlani and I'CL bexh have table objeas. The VIP-C and 
VIP Basic prociucis support a grid, which is t|uitc px>werful. fn all 
of these framewt)rks, it would hard to justify a Stone'lable 
purchase for simple tables. It would be cost efficient, however, to 


<hTtp://www.teleport.com/'-stack> 

<ftp://ftp.teleportXDm/pub/vendorsyslaclt> 

<stack@teleport,com> 

Demcj available at: 

<ftp://ftp.telepoft.corn/pub/vendor5/stack/StofieTableOemo.hqx>. 
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Deferred Garbage Collection 


Implementing a simple 
deferred C++ object 
garbage collection class 


Suj- Djujltimg Objects 
When developing object oriented 
softwiire using C++ there are certain 
siLualioas where you niiiy need an ol)jecL 
that can delete itself. For instance, you 
might have a window or dialog class that 
manages its own mouse clicks and key 
down events. But what dtx!S the dialog 
object do when it determines that the user 
has pressed the escape or delete key, or 
c:Iit:ked the window's c:kxse t:>ox? To slay 
true to llie ol>jeet oriented design, llie 
window should be able to do wkitever 
processing is needed when it determines 
tliai it is being closed and then free up the 
memory' allocated for the object by itself. 

Delfte This 

While the C++ syntax delete this is a 
legal call, it can amse serious prol^lems if 
the object that makes the call is referenced 
in any way after tlie call is made. This 
could possibly hapjxm while tlie stack is 
unwinding after a mouse click or key 
down event. 


Listing 1: The rGarbageCxiI lector Clas»> 

Tlie TGarbageColtccior ckss U a min^nstinte d^LS?; with two public stiitic methods: 
Ad(I,;uid Empty, ;tnd one pri\'5iie sliitk; member varLible: fTrasbCan which is pointer to 
aTGarbngc object. 

class TGarbageCollector t 
friend class TGarbagej 
public; 

static void Add ( void * trash )r 

stnitic void Empty ( void J; 

private: 

static TGarbagt^ ’ETrashCant 

I: 


TGarbagpColJector:: Add 

The Add method of the TGarbayeColIector class simply insunii^ies a iiew TGarbagc 
object passing it a pointer to the C++ obfcct to be deleted. Note that the trash pointer 
Ls a void pointer. 


void TGarbagcConector:; Add ( void * trash ) 
\ 

// crt:ate a new TGiuhagc object 
new Tdarbaget trash ): 


i’GarbagcColicctor:: Empty 

The Empty^ method of the TGarhajjeCoHector class deletes all t>f thcTGaTbat?e cjbjccts 
poimed to by the fTrishCan ^-ariable This methiKl shtjuld be called peritxlisMy at idle 
rime m the application’s main event Imp.The TGarhage object’s de.sinicror m,rintains 
the linked list. 

void TGarbageColiector;:Bmpty( void ) 

[ 

// delete all of the items In the trash can 
while( TGarhageCollactor::fTtaahCan ) 
delete( TGarbaEcCellector:ifTrashCan ): 


The TGAitBAGECoLLEcroR Class 

The TGarbiigeCollecLor class is 'A 
.sinii>le, drop in utility class that allows 
any C++ object to 1+e safely deleted at a 
later time. 


1 developed the rCarbageCoilector class as a part of an 
application framework I was designing. The easiest way to 
design the gartiage collection class would have been to have it 
delete only objects derived from a specific class, perhaps a 
TTrashableObject class. Bur, T wanted the garbage collector to be 


IVisirc White is n Mat:intf>.s!i programiiicT at US WBST Hex, Inc., where he develops client/server software used to paginate the 
US WtiS'l' phone directories. He can be reached at mwhite^e’agle.mig.iiswest.eoni. 
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able to delete any C++ objecL, and I didn't want to liave every 
class in the framework l>e derived frooi a single base class. 

The TGarbagf. Ciass 

This is where die TGarbage class comes in. Because the 
TGarbage class accepts a void pointer as a pointer to the objea 
it will delete, any pointer can be pas^sed into tlie garl^age 
collection class to be deleted. Tliis means that it Is up to tiie 
developer (not the compiler) to make sure that the pointer 
passed in Is a pointer to a valid C++ object. 

There is one more catch which I will descrilx^ in the 
What's the Catch section, but for now let's take a look at the 
TGarbage class. 



AppMaker supports most popular languages 
and frameworks. Just point and click to design your 
user interface, tlien let j^pMaker create resources 
and generate “human, professional quality code” 
to implement your design. 

Use AppMaker as a prototyping and 
productivity tool or use it as a learning tool 
for Mac programming techniques or 
for new environments such as 
OpenDoc, Java, or PowerPlant. 

AppMaker is just $299 and includes a 
one-year subscription on CD. 

B-O'W'E-R-S 

Development 

603 - 863-0945 

bowersdev@aoLcom 

http://memb€rs,aol-com/bowersdev 


IJslini; 2; The TGarbage Class 

llKlXinrba^- clnss Ls a siippk self-linking .singly linked list clas-s which accepts a void 
pointer through its constmetor. It stores a pointer to the ohjen to tfekte in the fTrash 
vambk and a pointer to tlie next I Giirbage objeci in the list in its fNcxl varUhle. 

class TGarbage t 
publIc: 

TGarbage { void * trash ); 
virtual ^TGarbage ( void ): 

private: 

void *fTi:ash; 

TGarbage 'fNext; 

h 


TGarhage: TGariiage 

ITieTC Garbage constructor stores a ixiinitr to ohfcci to delete in its firash variaWc. 

Next it links itself into the linked list pointed to by thcTGarbagcf^tdkclor’s sialic 
fTrashQn variable. It can access this private item since thcTfiarbagcCollcetor has tlie 
tkclared theTCarbage class as a friend. 

TGarbugc::TGarbage( void *trash ) : fTrashC trash ) 

I 

// store a pointer to the next iieni in the chain 
if{ TGarhageCollector::fTrashCan ) 

this->fNext TGarbageCollectorrrfTrashCan e 
else 

this->fNext = nil; 

// SCI tliis item as the first item in the trash can 
TCarbageCollectorItfTrashCan ^ ibis: 


Tc;arhagp:: -IGa rhage 

ITiLs Ls where the teal magic liappeiLs.Wheii the J Garbage object gels deleted wc have 
no idea what type of object its ITrash variable points to, all dial wc know is that it is 
pointing to a C-n- object. So just type cast it to a G4-I- cb.ss pointer (in this case a 
Ttiarhage pointer) and call tlie delete operator.ITse real object’s destruaor will gel 
called iuid its memory will be deallocateil it's just that ea.sy! 

TGarbage:■-TGarbage( void ) 
f 

// pul] this object out of the linked list 

TGarbagnCollector:;fTra^hCan = this->fNext: 

// delete the trash 

deiete( (TGarbage ') thiji->tTrasih ): 
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SAMPUi USAGli 

Let's take a look at the 'rOarbageCoDector class in action. 
Ccxie listing 3 shows the r><iKeyDown methotl of a typical 
dialog class. 


Listing 3: A Dialog Class Method 

void FDIalogi:DfiKeyT)o\#ti( char thcKcy ) 

1 

!jwilcti( th^Key 3 t 
case kEfiLiKey: 

// add ihb tjbjtxn lo Uic ira^sU 
TGarbafieCollector:lAdd[ this ); 

// hide this dialog; 
thiflOHideO : 

// d(i any mher prtk‘es,sing acedc^l heit* hetbtr ckising 
break; 
default: 

inherited::DoKeyDown( theKey ): 


Notice that the dialog can add itself to the trash at any time 
once it detcnnuies iliat ii needs lo Ix.^ dclcicd. Tlie dialog ol>jcct 
is still valid until the tnish gets collected. 

Next we’ll take a look at the event lcK>p method of a 
typical applicaiion class. This is where the 
TGarbageCollector’s Empty inetliod gets called and all of the 
objects added to the trash are deleted. 


Listing 4: An Application Class Event Loop Method 

void FAppllcfltlon::RvpnrLoop( void ) 

I 

Kvcm Record thcEveril: 

whiiet this->fauit “ false ) I 

ift WaitNextEvent( everyEvent, fetheEveot. 30, oil ) ) { 
switch( theEvent,whet ) \ 

// handle all mH-mal events here 
default: 

TGarba£oCollcclor::Empty 0: 
break: 

) 

\ else I 

TGarbageCollector:: Empty t) ; 

I 

I 

1 


What’s The Catch? 

So tliCTc has lo tx a catch, righL^' Wdl, tif course llicrc is. The 
catch is that any C++ object added to die trash must be structured 
in the same way as the object used to type cast the void pointer 
in the TGarlrage objeci Ix^ffxe calling iLs delete operator. 

In simpler tenns, any olijcct added to the trash must liave a 
virtual destructor, and its destructor must be the first virtual 
method of that class. Thi.s is becaij.se of the way a C++ objeti is 
structured from a clasvs. 

’llie TGarbage class typecasts the void pointer to die object 
it is going to delete into a pointer to a TGarbage objen. ‘iTiis 
instructs the compiler lo use die virtual table, or vibl, of die 
'LGarbage class to find tlie location of the objea’s destructor 
whic'h it calls iieffire cleallfK'ating the object’s memory. 
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In ihe of llie TrfLtii>iige dass, the destructor is tlie first 
vinual ineiluKi of tiie class and therefore will lu* the firsi entry in 
the vtbl. As long as any object added to the trash am has its 
desTHKior as the first item in the vibi, it will lx* pro[>crly chilled 
wlien the TGarlyage class deletes the ohjea. 

What would happen if the object l>eing trashed did not have 
a vimiaJ destnictor, or if the destnii lor was nt)L the first virtual 
method? If the object's virtual destructor is not the first virtual 
tiiethod in the class, or it's destructor is not virtuah then Ix^fore 
the inernory for that object is dealkK'ated the first virtual method 
of that clasps will be called. In the case of an object that d^>es not 
have any virtual rnetliods, the ohjea will not even have a vthl 
which means that st>me random memory location is goitig be 
executed as a methtxl Obviously, neithcT of these two scenarios 
are desirable, whicli is why it is very ini]X>rtant tliat the developer 
structures the classes for trashable objeas properly. 


in the inheritance chain has a virtual destructor as its first virtual 
method, the order (jf tlie virtual methods of the odier 
sui>crclasscs does not matter. 


Listing 5: Multiple Inheritance 

// dcsfnictor is the first virUial method 

class A I 

public: 

A C void ) I 

virtual ( void ) : 

I: 

// destructfir is the second virtiMl method 

class ^ I 

public: 

B ( void ): 

virtual void Test { void ): 

virtual ( void ): 

): 

// inh^'rit from A fi rsi, then B 

claus C 1 . public A, public R \ 

public: 

C ( void ); 

virtual '"C ( void j: 

I: 

// inherit from B first, then A 

class D : public B. public A t 

public: 

D ( void }: 

virtual "D ( void ): 

1 : 

In code listing 1, class A follows tlie virtual-desimaor^first 
method which would allow any ohjea of class A to l>e deleted 
properly by the TGarbageCollecltrr class* Class 13, however, has 
its virtual destructor declared as tlie second virtual method in the 
class, and dierefore, wniikl not lie deleted properly by the 
"rGarfiageCollector class* The B object's Test uicthiTd w'ould 
aaually get called when ihe TGarIrage cla*ss deleted it. 

Since class C inherits from class A first and class B seajnd, 
class C objects am successfully lie deleted lusing ihis metiiod. 
When the TGarbage class t'alLs the C object’s delete ojierator. the 
class C destructor will Ik* called first, the class B destructor 
second, and the A destructor third. 

Class D, however, inherits frt>m the B class firsi, wliich 
means that it wall iKliave exactly like a B object would when 
iKing deleted by the 'rGarbageCollecior, the inherited R object’s 
Test method will get called. 

So, even though there is an exception to the virtual- 
desirucior-first rule in the case of multiple inheritance, it is much 
safer to make sure that any object that might be deleted by the 
TGarhageCollector have its vinual tIeMruclor dedared before any 
other vinual methods* 


MumPLE blllERlTANCl: 

Can objeas that use multiple inheritance Ixr successfully 
deleted using the TGarbageCoilector class? In short, yes, as 
long as they still adhere to the virtuai-desLmcior-firsi method 
like the other classes. 

However, there is an exception. Depending upon how^ tlie 
compiler implements multiple inheritance (1 am msing 
CodeWarrior for this exam[>ie>, as long as the first class specified 


SlTMMARY 

TTie TGarf>ageO)lleeior cla*ss pn>vi<.Ies a simple means of 
adding deferred object deletion to any C+-»- application. 
However* the developer must make certain thai the classes of 
objects which will he deleted in this manner are stnictured 
according to tiie virtu a l-deslj'uctoi-first rule. Kl 
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by Ed Ringel, with Jeremy Vineyard 


NetYaroze on the Macintosh OS 


Is game console 
development for you? 
MacTech takes a 
lightning tour of Net 
Yaroze on the Mac OS 


iMKODDCnON 

Most of us like to play games, and 
some of us wouki also like to write our 
own. Besides desktop computers, there are 
console systems on the market s]>ecirLcally 
designed for playing games. Nintendo, 
Sega, Sony, and Atari are just a few 
manufacturers of these systems. Until 
recently, game console game development 
has been the exclusive domain of 
commercial developers. Presumal^ly, in 
this way only the best quality games will 
be created for their systems, and will thus 
most effectively promote their product. 
Sony has created a different c}ption, a way 
for hobbyists to create games for the Sony 
PlayShitifsn, without participating in the 
professional develo]>ers [)rogram. Tiiis 
program is called “Net Yaroze/ 
pronounced Yah-KO-ziiy. 

NlT YaROZI; 

What it is 

Net Yaroze is Sony's development 
package tliat gives hobbyist developers 
access to the PlayStation OS. Net Yaroze 
comes with a Net Yaroze member’s 


PlayStation, a special Net Yaioze access card, a lx>ot CD Ibr the 
PlayStation, a software development CD containing sitmpie code 
and libraries, and paper dtKumcntation. Net Yaroze is also referred 
to as Yarcjze, Hobbyists can subscribe to the Yaroze piograin for 
approximately $750 by contacting Sony. 

What it needs 

the Net Yaroze member’s PlayStation is a special black 
PlayStation with an added port in the back for txmnecting to a 
PC. In addition to developmcni, ibc Yaroze member's 
PlayStation can play any PlayStation game. Ihe Net Yaroze 
developer kit was designed for IBM compatibles, so it uses a 
connection that is not directly compalilde with any of the Mac 
I/O pons. To connect a Mac to Net Yaroze, you need a DB-9 
adiipter cai>Ie, also known as a modem cable (around $ 5-10). 
[Note iha! ibe amnectmn is DH-% not nH-25^ —HdJ 
CodeWarrior for PlayStation does not come with Net Yaroze and 
must be purchased separately for around $300. 

The Net Yaroze development system uses a serial port, so if 
both a printer and a modem are already hooked up to the Mae, 
a serial port switch box or PcjrtJuggler may l>e an excellent 
investment. I’hese devices range in price from $20 to $130 
depending on their capabilities. 

To debug ( and play ) Net Yaroze games some sc^n of video 
system Ls necessary. Generally, this means an external monitor, 
an RCA video input (AV Mac's), or a TV/video c:aplure card. 
Tltcre is no "rigliP' decision here. I tiave Ixxm using TurboTV- a 
cross-platfonn PCI W card for either Mac or PC, but I was 
disappointed by the extra compatibility problems introduced 
when 1 installed the card, k can tnake the computer somewhat 
unstable, and viitual memory^ must be off for systems l^efore 7.6. 
Unless you already have video input capabilities in your Mac, an 
extra cheap television may acmaily Ixf a Ixmer pur<'hase than a 
TV card. A “reaP’ TV lias the advantage of showing wliat the 
images will really to look Like, but the computer screen IV image 
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i.s diilicrud mid interlaced, even in millions of colors. Also, 1"V 
cards are convenient and make if easy to c:apture sc reensliois and 
QuickTime movies of your j^ames. Why die extni TV? Although 
most f>eo|>le already have a television at their disposal, they may 
not be willing to dedicate it solely to the purpose of debugging 
and playing Yaroze games. 

Wliat it isn't 

Net Yaroze is imy ciijfertml from commercial PlayStation 
development. The vision of Sony in creating this program is diat 
of a worldwide group of talented, progntmiTiing liobbyists 
developing games lo play and sliarc amongst diemselves, 
connected by the Internet under die help, care, and guidance of 
Sony. This is not a low end, alternative entry poini into 
commercial programming, but a hobbyist's club with many 
safeguards (or ohstiicle.s, de[X:nding upon how you see it) to 
prevent the dissemination of hobbyist developed games into the 
protected, quality controlled end user market. 

Net Yaroze games will run only on Net Yaroze consoles' 
dmy will not run on commercial PlayStations, Obviously, this 
is Sony's main firewall between the Net Yaroze and 
commercial development programs. Conversely, commercial 
games will happily run on Yaroze units. In fact, one perk of 
licing a Yarozian is that any commercial game for any of the 
target markets will run on a Net Yaroze box; there is no 
geographical lockout as with commercial games units. 
(PlayStations marketed for Nortli America, lor example, will 
only run games marketed for North America.) 

Another difference is that the code libntries pnivided are a 
Milisci of die aimmercial develojimeni lifiraries. Also among the 
main differences is a ceiling on code size for Net Yaroze 
development. 'Ihe licensing program, although rcasonalilc, 
appears to lie no nonsense in ctianicter and would pmbalily not 
lx: tolerant of cTforts to breach the hobbyLSt/commercial 
separation. Ibe reader is recommendeti to the web sites 
mentioned at the end of the article for st>me excellent FAQ pages 
that lielp delineate the s|icctfics of the program. 

Thus, although PlayStation development may hold 
considenible interest for the hobbyist game devclo|K*r, the 
up-front cost may lie substantial. Furthermore, theiie may be 
several hassle factors: loss of a port, Mac QS specific emts, and 
the pros and cons of various video output solutions. 

Li^AKNiiNG To Program fob Nft Yaroze 

Tlie Net \aroze package comes with three manuals: a 
startup guide that shtws you how to set u|> the Net Yaroze and 
run sample programs (for IBM PC's); a user guide that explains 
the various components of die PlayStation OS; and a library 
reference manual that contains descriptions of library' functions 
that can l)c accessed when writing Yaroze software. 

Tlte manuals are thorough, but they descrilie a complex 
environment. PlayStation game developers must deal with 
most of the same problems as do game developers for PC'S; 
game console development is far from easy. Proficiency in C 
or C++ is required to he able to understand the documentaLion 


and sample code. C is strongly recommended as the 
development language by Sony. C++ is not officially 
supported, although can be used. 

Net Yaroze* has its own web site specifically designed for Net 
Yaroze developers. 'Ibis web site contains sample programs 
written by other Net Yaroze users or by Sony, docitmentation 
concerning PlaySiaiion data formats, and other useful 
information concerning Net Yaroze development. The web site 
also contains utility programs For Net Yaroze developers, but for 
now [hey are mostly only for IBM PC's. 

Net YAROiTH on MAtaNTosn 
Setting up the system 

To set up Net Yaroze for Macintosh, the prospective 
developer neecLs to follow a few simple steps. First, in.sen the Net 
Yaroze access i:ard into the PlayStation. Next, coimea the 
PlayStation to die Macintosh serial port using the DB*9 adapter 
cable. Then, install Code Warrior for PlayStation and die 
supporting Yaroze libraries. Finally, Ixxit the PlayStation with die 
Net Yaroze Ixxit CD. After following these steps, programs and 
data files can l>e downloatled to the PlayStation. l,et's take a 
moment to look at the Mac OS specific development system, 
Cotie Warrior for PlayStalkm. 

CocleWairior for PlayStation 

Code Warrior for PlaySiaiitai is a plugin for the CodeWarrior 
IDK environment. By niainlaining a standard interface, 
developers familiar with the GxleWarrior IDF will have liule 
trouble writing code for the PlayStation. The CtKleWairior for 
PkiyStadon package includes die IDF and plugin for both Mac 
and Windows platfoniis along with on-line doaimemation 
explaining how to target the PlayStation pkittdrm. It also includes 
a rtK)l for converting graphics to TIM, the Play Station graphics 
format, and <jne sample jii'ogram for Net Yaroze. 

CodeWarrior for PlayStation is still in its early DR .stages, 
so developers should be caitiious when considering a 
purchase of this product, rhe environment itself is stable, but 
the toiils are sparse and not very well developed at fhr.s point. 
Fortunately, Metro we rks is working on improving tools for 
PI a yS tat i on deve lop me n l, 

CurFcnlly, it is impossible to run many of the sample 
progj^ams that are posted fin the Net Yai'oze web pages because 
source code is not available, but Mclrowerks plans to fix this 
shoiicoming in t!ic near future. 

PlayStation technical .support was variafile. I ptisted several 
technical questions on com p.sys. mac. j^^n^grainmer. code warrior 
and hiiti replies from several jX'Opie that same day. An e-irail to 
tech sup[X>rt however, receivetl no response. 

Write Some Game^i! 

To write games for the PlayStation, a developer miisl 
understand the PlayStation OS and libraries which are descriiied 
in the reference manuals inctluded akmg widi the Net Yaroze 
environment. The developer must then convert any graphics or 
M)und daui to the appropriate PlayStation cbtta formats using the 
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tools provided with CocieWarrior for PlayStation. Conversion 
t<K>ls can alstj be found on the web, After the PlayStation cxxle 
has been written in C or C++, it t:an be t:ompik:d into a 
PlayStation executable file which is Uicn opened into the 
Metrowerks debugger (die releiise that comes with CcxleWarrior 
for PlayStation must be used). Once a PlaySiation file is opened 
in the debugger, it can be downloaded to die PlayStation- At tliis 
point, you will lx: playing your very own, custom-made 
PlayStation game! Now, let’s stamp out the bugs. 


_M 

1 5 
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f'j^irrc' /. Nei Yaroze Sample Program. 


Where should you go 
for an installer today? 


Microsoft went 
to MindVision 
for OfficeSS. 


MicRij^ifl’s iipcomuigOffia^ 98 for Maciiuofdi uses brsialler by MiiHlVLsk)ii. 

Adofcx^ Metrowerks, MaotMiKdia—tiiajor software cf^mpsuiks anniml 
llie world coiTie lo MmdVLsinn. So if you want an installer and ti’chniod stipixm 
that cm po the dLstance luakc your choice Insiailer VISI^! 



lAiiiuw . mindvision. com 


MindVision I 
Software 


402.477.3269 
Fax: 402.477.1395 

sales@mindvision. com 


Oetifnedjor 


* ? 


Microsofr 


( )S WindowsNT 


Wlndow^95 

IttIt'rTHmfi, Varxlijm 95, WiadtJKl^n.VT, Cl||iv97, MAl'Ot!, Alhllw. MOlOwCri® 
tHNl Mirr™tm.tlb atv rcglslieml iliiHr tisiiw.iiw' 


Debugging PlayStation Games 

Cross platform development can tax even high end host 
computers. Environment limits are especially noticeable during 
the Net Yaroze debugging process. Because the debugger must 
communkate with the PlayStation through a serial cable, the 
debugging process, even at its fastest terminal spee<l, can be 
painful. Stepping through in the debugger is slow even on a 
200 MHz Mac. It is not po.ssilile to switch programs after one 
has started running. In.stead, the PlayStation must be reset 
manually every time a new program is to be nin or the same 
program is to be rerun. This t,s partkulariy ineffident and slow 
because of Sony*s startup advertisements. Metrowerks plans to 
fix this in an upcoming release. 

Perhaps the most serious problem witli the debugging 
pOKe.ss is that breakptnnls cannot l>e set or edited while die 
PlayStation prognun is ninning. llie iniphotions of this are that 
developers must decide exactly where they want their 
breakpoints before starling debugging, somedimg tliat is difficult 
to do widi larger projects. According to Metrowerks, This is a 
hardware limitation and cannot lie fixed. 

Slimmaky 

Net Yaroze provides hobbyists with the opponunity to write 
authentic console games. Until now, that has Ijcen difficult to 
accompti.slc MetrowerLs is currently working on new tools that 
will make Macintosh Net Yaroze development much easier in the 


near futunj. The would-lie console game programmer .should lx: 
aware of the limitations of the system, the steep learning curve, 
and the costs involved. Nonetheless, Net Yaroze development 
might lie a new and satisfying unclenaking for the hobbyist, and 
give the would-be professional a chance to lest ihe waters. 

PROUlfCJS RtVlCWED 

Net Yaroze, Sony Corporation. See URL's for contact 
information. 

CodeWarrior for PlaySuition/Net Yaroze. See UliVs for 
con tael information. 

USERIL URL\s 

<www.scea.sony,com/n€t/inclex,html> is Sony’s home page for 
Net Yaroze information, 'ihe interested reader is siiongly 
recommended to this page. In particular, Lite FAQ f>age can really 
help ytxi make a decision regarding purchase. 

<www.Meirowerks.com/producis/cw/playstaTiofi/cwps/index.html> 
and <www.lVletrowerksxom/products/cw/play5tation/netyaroze/indexhtml> 
are two pages arc Metrowerks index pages into CodeWarrior for 
PlayStation and CodeWarrior for Net Yaroze, Again, the interested 
reader is vigoroasly retaimmended to these pages. Both the Sony 
and Metrowerks f>ages have links to related sites, email contacts, 
registration foniis, etc. B1 
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Sean Parent: 

The Photoshop Development Process 


One of the most complex applications 
on either side of the ^^reat divide has got to 
l>e Adobe’s Photoshop, Tliis mtmth's 
Factory Floor interview is witli Sean 
Parent, Photoshop engineer extraordin;tire! 

Sean Parent <mailtD:sparen®adobe.com> 
is an engineering manager and senior 
computer scientist working on Adobe 
Photoshop. Being llie author of Actions (a 
Photashop 4.0 feature) has earned him the 
riicJtnaine “Official Photoshop Action Figure.” 

Sean joined Adobe in ‘93 aiming from 
Apple where he was a senior software 
engineer worldng on the PowerMac piojea. 
Wlien he*s not working, you can find him at 
your loail coffee shop or rushing home to 
spend a few minutes with Ills family. 

Dave: In general terms, tan yoii 
describe the Photoshop develop¬ 
ment process? 

Sean; If I had the time, I could write a 
Ixiok on this topic, Photoshop is a very 
large application, on the order of a 
million lines of C++ axle, and we have 
a relatively small team, currently alKxit 
12 engineers, working on it. Our goal is 
to ship eat'h release simultaneously on 
Mac and Windows and our tier tme 
languages (English, French, German, 
and Japanese). We have a RjII version 
and a light version of the paxtiid 
(Photoshop LE) and over KK) plug-ins. 


Feature ideas come in ltm>ugh market research, tech support, 
and from the team as a whole. We als<? have a small set of 
target ctLstomers with whom we wxjrk very closely. 
Engineering works with marketing to prioritize the features 
based on lx>ih customer demand and feasibility; Each engineer 
is assigned a feature, and that engineer will research the issues 
and w'riie a short design document with input for HI, 
marketing, and QA. Tlien he or site will imt>lcmcnt the feature. 

As each feature is completed and tested the engineers move 
to anotliLT feature. Each engineer is resptjn.sibic for keeping 
his hug count below 25 and testing occurs thmughout die 
product cycle. If your bttg count goes alxwe 25, it becomes 
your highest priority, 

Dave: What is your general approach to localization? 

Sean: We have lx.'en sptmtling a Uh of rime working on 

localizaiitm for die next release, trying to sireamltne tfie 
process. Our approach is to imlx^d string tokens for user 
visifile strings tlirecily where they are used. At runtime the 
actual text is lotrked up in a unictxle file fnan the token. The 
unictxie text is mn through a translation taiile for the cunent 
platform script and used for display. We liave tools that scan 
die stjurces and generate reptms alxjyi new strings, mttdified 
strings, changed strings, duplicate tokens and the like. 
Translators are given a Unicode text file with the tokens in 
them and they just replaie what they are et|uivalent to. 

We also liave an auto iayout mechanism. It currently is a little 
heavy weight, you have to enter expressions to completely 
describe the layout of tlie view. These expressions are 
evaluated at runtime. 1 plan to, when I itave the time, replace 
this with a lighter weiglit and easier to develop for model that 
Fve I seen working csn. 


We try and keep prxxt!SvS minimjil, with 
just enough in place to keep the 
complexity' from liecx^niing chaotic. You 
can easily spend more time working on 
tmxess llian you do working on pTvxlucl. 


Ihls whole mechanism makes it very e;isy to develop since 
you jii.st add strings right where you use them, and it makes 
it very easy to translate. We have Fig Lain and a bunch uf 
txher wacky versions of the application. 
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Spotlight Memory 
Debugger 

Spotlight is the first itiiromatlc memory 
debugger for tlie Miicintosh. Instantly 
detect invalid memory acces^ses, memory leaks, bad 
toolbox parameters, stack ovenvrites, memory rek> 
cation problems, and more. Spotlight can find prob- 
leius in seconds that might take you a week to fix by 
hand. 

Spotliglit uses your XSYM file to automatjcaJly 
patch your IY>werlYI native application. When 
Sptlight detec'ts an error it brings up the exact 
souR’e code line wiiere the ernjr occurred along 
with stack crawls, memory' views, and program vari¬ 
able usage information. 

No need to change your source code. No need 
to recompile. No learning curve whatsoever. 

Spotiij^it’s Object Ctxle Replacemenr instrumen¬ 
tation inspects each Pow erf^ pr(x:essor memory' 
read and write instruction in pur axle as it is run. 
Spotlight detects faulty memory reads and writes 
that oceur between bitxks, in released bkxks, 
acros.s multiple blocks, and outside of your heap. 


NEW I 


VERSION 




Features 

m Stojxs your |>[T^Tain on exan 
source code line w'heie a tiad 
memQi 7 write occurs 
m Complete leak reporting with 
source code stack trace show^ 
ing point tjf alkxaiion 

■ I'ully validates parameters to 
over 400 Mac tcxjibox APt 
calls, 

m Works on all heap allocations 
Mac Ibollxix, C 'malkx:’, 

C++ new'and delete 
m Supi^oas any language diat 
produces an MPW or 
Metrowerics XSYM fde. 
m Full logging and ignore capabilitic's 
m API fur fine luficxicontR)! 

■ Purchase includes one year suhscripLion to 
dowmloadalile u|xiates 

m 30 day money back guarantee 

■ Available for secure electronic purdiase now' 
at ourw'eb site 


Requirements 

Mactrdosh or Mac OSrCompaiiblii i Ol7^iltler witb a PPC 601 or 
gfvaier pme^r MW requiremerUs vary depminig on tar¬ 
get apptkatioii size; 2 \fH ban! eM space, Syslem 75 or kUer; 
MmnAi)(rr^orMPW mmpaiMeXSYM smdjdkfiie 

Download free demo at http //www.onyx-teth.com/ 

$ 199.00 

TEL (9^1)795*7^)1 E-MAIL ,sdes(5?43n^*ttdvaini 

FAX (941) 795^5901 URL iaip//wi™.oiiyHfl;h.L™ 


Dave: Any interesting opportunities for developers in 
the next release of Photoshop? 

Sean; For those familiar with Photoshop 4.0, there is a feature 
c'alled Actions, An Action is like a small macro, you can 
record a ,sei of steps (Action Commands) and llien play llieiii 
i:)ack. For the next release we are exporting an API to the 
Action system. You can now' construct an Aaion Command 
and then send il to Photo,shop, The model is similar to 
ApplcEvenus l^ui a bit easier to code to and it works cross 
platfc:irm. Ihrough this API you can bridge Photoshop to 
other scripting systems, or write plug-ins ihal drive the 
application U> do all sorts of things. 

Dave: When we were discus^^ing plug-ins you mentioned 
a unique menu enabling technology developed for 
Photoshop. you tell us about that? 

Seam Most Photoshop customer.s have well over a liundred 
plug-ins. It would be prohibitive, even for Photoslx^p, to 
keep these plug-ins loaded at all times. And it is too time 
consuming to load each plug-in separately to query it to see 
if it is available given the current dmrumeni suite. For 
Photoshop 3 0 we just had a set of flags that the plug-in 
w^ould provide, but wath all the variables of a Photoshop 4.0 
d(x:iirnent this was !)reaking down (the state of a dtxuinent 
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includes color mode, transparency channels, color depth, 
selection, layers, etc.). The solution was to use the expression 
evaluator, originally written for the view system and have 
each plug-in provide a Ixxdean expres,sion which is 
evaluated Lo detcniiine if the plug-in should be enabled. The 
expression evaluator is alx)ui 3K of code, just a simple 
recursive decent parser, and can calculate thousands of 
expressions per second. 

Dave At this year's Macllack, you gave a presentatkm on 
managing the Photoshop development process with a 
relatively small team- For those folks who didn’t get a 
chance to see the presentation, can you discuss some of 
the core issues here? 

Sean: I think the biggest issue tn developing .sofm^are, 

Photoshop or any other major project, is keeping things in 
control. 

The traditional approach of getting all the features to-driving 
for an Alphii tlate — and then bringing on QA is usually a 
disaster. Quality Is an aftcrtliought, with feamres taking 
priorily and you end up with a .soaring bug count, f rying to 
rip half completed (and wastetl) features from the poxluct to 
gel to a pijinL where you have sonictliing shipable. This kind 
of dcvelopineni goes on all over die valley and is why 
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software dates slip. If you have a bug count over 10,000 how 
do you even I)egin to schedule a ship date? 

Photoshop Follows a more evolutionary cycle. Each feature 
moves to coinpleTion before we move on. QA is active for the 
entire life cycle. We have tnorc QA engineers tlian we have 
development engineers. By developing like this w^e a\n cut 
off development when we are feature rich enough to call ii a 
relase, wrap it tip, and ship. At any point we can cut off 
development on Photoshop and have the application ready to 
ship, from engineering, within 3 months. Of course we have 
TO schedule dtxiinientation and ouLside dependencies, so 
FTtaking a cut is non trivial but we can be vcjy resjXJnsive. 

‘Ihe other big issue that sends development out of control is 
what 1 refer ky as ilie "‘fan effect." This is all the stuff tliat 
liai>jK*as after you hit that big ship date. You have a hunch of 
people leave on vac’ation, yoti might loose a member or two 
of the te^im from burn-out, you might have to do a bug fix 
release, you have tier 2 and 3 languages to get out, marketing 
strikes a deal with someone to bundle your pro<luct but they 
nee<i a new version, you need an updater to go on the iniemei. 
People lend to f(xn.j,s an that first US relea.se and fotget alxjut 
the fan effect. All of these tasks chew' your res<Hirees that 
should 1^ working on the next version. We are con,sianily 
l<x)ktng at how to manage iltese is^sues, how to plan for LlK'in, 
how to avoid tliem, and how to do tliern in parallel. The goal 
is to hit that ship date and move everyone to the next version. 
We are still a long way from that goal liui we iiiade a lot 
progres.s lx!iween PtioUxsIiop 3.0 and Pholosliop 4,0 and the 
next release* make.s many more iniprovemenls. 

Dave: Photoshop is clearly a performance sensitive 

application. What process do you use to tune Photoshop 
for different processors]?' 

Sean: Pfioioshop is arcliiicxted ,st) most of the perlbnnance 

oiiical code is isolatetl int(> a set of iiottlenecks" that can lx* 
overridden, Ihere are about 500 bonlenecks and ihc,st* gel 
tuned lieavily ft>r each target pUKessor. For the remainder of 
Pliotoshop, we fcK’Lis on picking efficient algorithms and 
writing maintainable, robust code. Ihen we measure it and 
tune what Is needed. 

Dave: Pliotoshop is about l,a0Q,()0t> lines of C++ cinle. 
What kind of framework do you use? With such a 
massive code base, how do you keep it current? 

Sean; PlxHoshop was originally written with MacApp 1.1.1 in 
Object i^asr al. For PhoUishop 2.5 it was ptJrted to MacApp 3.0 
and C++ and also ported to Windows. During Photoshop 3 0 
development Apple canceled the MacApp project (it was later 
resurrecietl) and the Photoshop te^im UK>k over development 
of the framework. It still Ix^ars some resemblance to MacApp 
but we did our own port to PPG, we have modified tlie view 


system, added .scripting, our ow n exception handling system, 
and ligliLcned op a lot of the framework. Over 95% of die 
code is shared between Mac and Wmdow.s, 

For the next release of Pliotoshop, 1 would estimate that close to 
50% of tile engineering time has gone into imprtivemenLs in the 
code basOj not features. This is always a icmgh diing to I valance. 
It Ls easy to spend Uxj much lime working on architecture and 
not end up with a product and equally as easy to hack feature^! 
in and end up with an unmaintainable code btuse. 

We try and keep the code !>ase up to par with the latest 
language spec, OS features, coding practices, eu all. The team 
is encouraged to spend time reading and Mark Hamburg (my 
manager) and I are frequently handing out l>ooks to the team 
and making nins to Computer Literacy, Witli as much code as 
we have, correct and robusi tools are very im|x>rtant. We are 
constantly trying out the new features in the compilers and 
trying to raise the bar on our code. When a new^ language 
feamre becomes available it is rarely supported well enough 
through all the tools that wc can adopt it right away, but we 
ain gain some experience and push tool developers in the 
areas we feel are important. 

STL (the C++ Standard Template liharary) i.s a good example. 
It piovide.s a tjemendous amount of power and am greatly 
simplify coding. But suppem for templates i.s still weak among 
the compilers and linkers (the VC++ linker has a limit of 255 
charaders for a syrnlx)!, and STL can quickly exceed that). 
You can als^i get a fiiir amount of code bloal using STl., and 
none of the current t(K)l vendom have linkers that will fold 
ideniit'jjj routines (ii is very conunon with S'!! to have 
multiple methtxls tliat generate identical code but are 
opemting on different types). We have sianed usitig STL, but 
slowly uniil we gain exjKTience and the tools gel fietter. 

Dave; Photoshop is one of the first major applications to 
take advantage of the Latitude potting libraries. What 
can you tell us about that experience? 

Sean; Photoshop 3 0 was shipptxl for Sun and SGJ built with 
ratitiide. At tliat time the Unix PhoUrshop team was a separate 
ptjiting team (they were even in a different division). The 
port went relatively smoothly, it took a team of 5 less than a 
year to release. The code iiuxlillaitions they made have since 
lx‘en rolled into the main code l>ase, A lot of the changes 
were to get Photfcshop compiling with the various compilers 
and tuned For the specific plaffornis. The one great side 
lx*nefil was l>eing able to use M>me of the liNix debugging 
tools like Purify — we found and fixed a number of difficult 
prol>Ienis ki the main ctxle base frf>m this effort. 

kititude supports a large portion of the Mac APT with a large 
degree of fidelity'. Even direct access to many datit structures 
is .supported, it was t'cnainly a much easier way to get to Unix 
than a direct port. HI 
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PROGRAMMER'S 

CHALLENGE 


by Boh Bootistra, Westforci, MA 



Clltellss Crosswords 

A t:c>uple of montlis ago, Bob Noll sent me a Cjiallengc 
suggcslion involving a tTcxsswc)r<:l puzzle variant pulilLshed by 
one of his local newspapers. The difficulty in using that 
suggestion was cledcling how to provide the dues to the pu/:/ki 
in a usable ffirm. f thought about providing some sort of 
thesaums, l>ut giving simple syncmyrns as clues didn't seem to 
capture the crossword spirit. Then it cxrcunred to me that clues 
serve only to make the crossword easy to solve, an advantage 
that eenainly wouldo'i be needed by our skilled Challenge 
readers or by die crxlc iltey write. So ihe Challenge this month 
is to write code that will solve a crossword puzzle without dues. 

The prototype for the cotie you should write Is: 

kMaxSlze 32 

lypedfif char PuzzleIkMaxSiz^I[kHaxSizel; 


void CroBsvordt 
Fuzzla thePuzzlo, 
char 'dictionary[], 
tona puzJiloSlze, 
long diet Size 


/* tt^iurn solvii:i puzzle here 7 
r array of word^ lo choose bom */ 
/* mimlxT of rt>ws/cols in puzzle 7 
r iKiniticr of wonh in dictionzry 7 


Your Crossword routine will he prt>vided with thePuzzle, 
where ceil thePuzzle[row][col] will be initialized to a zertj if you 
are to llll in that cell, or initialized to OxFF if" the cell is biacked 
out. 'Ilie fust puzzleSize rows and columns constitute the puzzle; 
the remaining cells in the Puzzle array are padding and should 
l)e ignored. You are to fill in the empty^ cells of thePuzzle vvitli 
words from die dictionary provitled, such that each uninterrupted 
sequence of blank cells, IxaJi horizontal and vertical, forms a 
word from the dictionary. 'Ihe dictionary wil! contain all of the 
words needed to solve thePuzzle, but, to nxike things more 
interesting, it will also contain extra words not neetled to solve 
thePuzzle. Ihe dictionary may conhiiti only a few extra words, or 


ir may contain as many as 10 extra words for each word ased in 
thePuzzle. Words in the dictionary are not guaranteed to be in any 
order, and any word juighl be used more than once in thePuzzle. 

Each puzzle is guaranteed to have ai least one .S4>lutian 
using the dictionary provided. You will he guaranteed 20MB of 
memory for your cmle, static data, and any dynamically 
allocated memory. You may use more memory if it is available, 
but your code should detect and respond to tnemory allocation 
failures if you ask for more than the guaranteed amount of 
memory. As always, y«)u must dealiocaie any dynamically 
allocated memory before returning. 

'lliis will be a native PowerPC Challenge, using Uie latest 
QxleWarrior environment. Stilutions may hi* cfxled in C, C++, or 
Pasail The Cliallenge winner will lx* the entry ihai provides a 
eorrect solution to a set of crossword puzzles in the minimum 
Lime. Thanks to Bob Noll for suggesting a crossword puzzle 
()rohleni — he wins iw^o Challenge p<iints tor the suggestion. 

Three Months Agc) Winner 

Qmgraiularions to Ludovic NicoUe (St-Nicolas, Quebec) for 
sui^mitting the winning entry in ihv. Image Defector Challenge, 

I lie problem was to find all cxcurrcnces t jf a given pati ern 
bitmap in a sequence of background I'iitniaps. subject to a 
spcciried aliowalrle errt>r rate. Five people .submitted entries, and 
all but one of them fXTfonned correctly in my tests. 

Boih the winning entiy and the close second place entry l)y 
Ernst MunLer used 64K of static memory^ to took up the numlxr 
of hits set in a given value, as pan of calculating the 

numlxr of mismatched l^its. Ludo gained some advantage l>y 
optimizing the detection routine DeteetCenter, used to examine 
mast of the trackground image, to pnxess 16 potential matches 
in parallel and thus take advanuige of die many registers 
available in the 604 processor, lie also used an iniercsiing 


THE RULES 


Here's how it worbj; each month we present a new prpgmmminf; 
chiillengv. i'irst, write .some codi; that solves the chaltenge. Second, optimize 
ycjur (a Inti Then, submit your solution lo MacTech Majtaziiie. We 
chotxse a winner baivcd on code correctness, speed, size, and electa nee (in 
that order of importance) as well as the subniission date. In the even: tjf 
multiple equally desirable s^jluiions, wrll chofisi! one winner (with 
lionorabte mention, but no pri^e, given to the mnner up). The pnze for each 
montli's best solution \s a $K10 credit For Developer Depot^. 

Unless siaterl txhcrwi.se in the problem siatemeni, Uk? following rules apply; 
All soluik>fis miLsi be in ANSI comtXitil:]le C m C++, or in Pascal. We diMjmlify 
entries with any asseiiJily ui iIkmii (exeqx for thaUenges .spcdfirally stating 
otherwise.) Ychj may ealJ any Madniosh Ttxilbtrx routine (c.g., it doesn't matter if 
you use NewPii instead imlkrcX We compile all entm^s trrtr> ixuive PowerPC 
axle widi awnpiler options set to enable all availnWe speed opnmi;Qtion.s. llie 
develi>pmteni envirtrnftx'nt to l>e nstd for selecting the wiiuKfr will be slated in die 
problem. Ijmit yowr eode to 60 characters per line oreoiupiess and Irinhex tlx; 


solutioi:!; diis helps with c-iiiail g^ueways ;md page layout 

'We puUlLsh Ihe soluthm and winners for each montlVs Programmer's 
t^rallenge three raontlts later. All .submissions miLsi be RTcived by the Ist day 
of the month printed on the from cover of liiis issue. 

You can get a head start on ihe Challenge by reading llie Programmer’s 
Challenge nuiiling list, li will be posted lo die iLsl on or before ihe I2ih of ihe 
preceding month. To join, send an email to lLsL>er\'OlUtmail.xplain.rom with 
iJie suhtect 'subscribe challenge-A'. 

Mark .solutions ‘"Attn: Programmer's Challenge S<iititkm* and send it by 
e-mail to one of the Programmers Challenge addresses in Ihe "ilow lo 
Communicarc With Us" section on page 2 of Uiis issue. Include the s<jluLi<m, 
all related files, and your tonlacl itifo. 

Madech Magazine reserves the right lo puhli.sh any solution imrered in 
the Program me rs Challenge, Authors grant MacTcf h Magazine the exclusive 
right uj publish entries without limitation uptm submission of each entry. 
Authr>r.s retain crTpyrights for the ciKJe 
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techni<|uc to trick the compiler into keeping other local variables 
in registers, by declaring them to be paratneicrs. Finally, Ludo 
notes in his commentary ihai the branch prediction capability of 
the 604 caused him uy select a different txxle constnici ihan the 
one that worked l>est on a 601-based maeftine. 

The table below lists i\\c execution time, code size, data size, 
and prttgramming language for each entry. ‘Ihe mimber in 
[>arenthescs after the entrant's name is the u>tal nornlKT of 
Challenge points earned in all Challenges to date prior to this one. 


Name 

Time 

Code 

Data 

language 


Ludovk Nicolle (28) lj.74 

8606 

65860 

C 


Ernst Munter (290) 

15.96 

5276 

65896 

C++ 


Greg Cooper (54) 

87.04 

2420 

2045 

c 


ACC Murphy (30) 

252.71 

2596 

120 

C++ 


A.H. 

431.30 

4076 

164 

c 



Looking Back to May - Equation Evaujatou 
Ron Avitzur, author of ilie Grapliiiig Calculator that inspired 
the May Equation Evaluator Challenge, wrae to mention a 
techni(|ue lliat was not used by any of the entries in that 
Challenge, Ron pointed me lo <http://symbolicneh‘ 

mcs,kent,edu/areas/cr>, which discusses a technique called Cliains 
of Recurrence for optimizing function evaluation. 'Ihe technique 
can provide speedups of a factor of 50 when evaluating ftinctions 
over a range of uniformly spaced poinis. The web [xige allows 
you to enter an equal ion and then demonstrates the 
improvement. Tlianks for tlie lip, Ron! 

AND Back to Juiy - Disamuiguatok 
Ernst Mimter wrote to point out a low-memory bug in his 
winning entry For tlic July Disamhiguator Challenge that did 
show up in my tests. Erast wrote to say that "the published 
program works fine when tesled with a gencaius allowance for 
private storage, as originally sjx^cificd, i.e. at least 21 byles/word 
+ 1 byte per character of each word. However, the program was 
designed to require only about half as much memory’. 
Unfortunately this has resulted in a bug which will occur with a 
findstring of"" (return all words) l^eatuse the funciton SendAIIQ 
will start scanning from pageGroup[0]. But pageGroup[0] was 
aliased to nextPage, just a lemporary jK>intcr variable, and never 
properly initialtzed. If memory was plentiful, the memory 
pointed to by pageGroupfO] wtjuld still lx* 0, and nothing l)ad 
happens, but otherwise it is likely to contain .some data and 
result in an unmapped memory exception.'' Ernst provided the 
following replacement function to fix this hug: 

SendAlKCCC matchListf} minLen) f 

// Studs it wtMtls >= minimum length fmm all pa};cs 
ulong nuiiiMaTcii”0: 

/’ insert the fullawinji line to fix bug V 
If [iniTiLeii< I]l JnlnLen^l: 


foe dm ,EnifiCen) ;len<32 t 

Page* page’=pageGroup [1 ; 

while (page) I 

numPfatch-page' ^SendAlltnialcMa Rt-.rnsmHfittth): 
page=page->aext; 

I 

I 

return numMaich^ 

I 


Top 20 ConitiSTANI^ 

Here are the Top Ct>ntestants for tlie Programmer's Challenge. 
Tlie numl>crs l>clow include points awardcxl over tile 24 most 
recent contests, including points earned l>y this month's entrants. 


Rank Name Points 

Rank Name Points 

1. Munter, Ernst 

210 

ILPicao, Miguel Cruz 

21 

2. Cooper, Greg 

hi 

12.Day. Mark 

20 

3. Ijcwis, Ecter 

57 

13 Higgins, Charles 

20 

4.Gregg, Xan 

53 

14.lArngyei, Eric 

20 

5. Nicofie, Ludovic 

48 

i 5.Siuder, Thomas 

20 

6. Boring, Randy 

41 

l6.Saxion, lorn 

17 

8. Murphy, ACC 

.34 

n.Gundrum, Eric 

15 

7.Mallctl,Jeff 

.30 

18.Hart. Alan 

14 

9. Larsson, Gustav 

27 

19. O’Connor, Ibrlough 

14 

lO.Antoniewicz, Andy 

24 

20.1uir.sh. Bill 

12 


lltere are three ways to eiirn points: (1) scoring in the top 5 
of any Challenge, (2) Ix-'ing ihe first i>erson to find a bug in a 
published winning stslulion or, (3) being the first person to 
suggest a Clialicnge dial I use. llie points you can win are; 

1st place...20 points Sth place...,.2 points 

2nd place —10 points finding bug .. „2 p<)inLs 

3rd place. J points sugge.sting Cha)lengc...2 ixjims 

4th place..4 points 


Here is Ludo’s winning solution: 

InigOelcctonc 

@ 1997 ludovic Nkolie 

r 

(itiTL'ml is-sucs: 

llic code uses 5 fiuKiUias.DOoiUh/CfnitT/Kiglu tu lliid nuidics uti cmh siik and in 
the middle:.Ilir s;iijjc ihrcr functiuns aif ami ftir the tup/Lcnter/lxittum oil cadi 
cnlumn. 

Algfirirlimlc oitisukrnititirLs: 

die lundimKmttil <>p(TJtion lor odi hit nf the mtiu^k at anv particular kM'tirion on the 
tillage \s the fiiJlnwIng tme and aftrrvd as the x(ir/and bicr in this dbiussinn: 
mismatch - (patient ^ backgnjund) A mask; 
it mismatch — l.you giui a bit mismaich. 

^iince it was assumed the eude wuuld mure iiniuraily be called with (nnise <0.5) than 
grt'ater.it made sense to count the niismaiclicsThe code act u^Llly substract any 
mismakh frimii the nLiximum allowed. (Tlie variables immcs are inaxBad for the 
maximum and rcraflatl for the remaining alkiwed bad biLs at any time in the pfoces.s.) 

The fim natural step uf upUmixatiiiti was to treat the data in parallel, etdier H. 16 or ^2 
hits at a time. 1 dtos^e to work on a 16 bit5 basb. After the entiit opcnitum of xor/and 
has been done on 16 bits, the nonitier of Ts in the 16 bits is loaded from a 64k static 
army (named gBirsOn) containing a 2^ 16 cban» (this method pnive<1 to be statbticaJL) 
much faster tlmn anything else). 
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SiMcv wc ittrcded to^mfive" liif ma^ik and patum in paiuliul «vtT tin; b^ck^jund^ I 
L'tuM)M:d U) nK^vc tbc! hai^kgr^^uniL in^trjd ^ I had i^iiJy <hic varialdc to Mhitt each time. 

In ihe l>ecirrtirfi/Right functituti^jtHir code reflects otily diose considrationi», with a 
special treaimcm for the kinder when it is tww flush. 

Tile IXimCciucr fuiicUon uses a more sophisticated algpritJim derived form the 
sUnpk owe described above. While written in pure C portable cotk. is is R*ally 
opiiitiizcd for the nrjtisicf-rich h>werPt‘ architect une 

It use's Ih registers to irxni I6“rcin0ad" in parallel, liaclt lime a short is loaded Tiir the 
pal tent anti for the mask, it is used to xor/and with 16 differem positions of the 
baekgnujnd Rediielng the numkr of loads fnun the memor)' mascimi 2 )t the irwugliput 
tif the funciion An other tegisier is ustxl to globally' mtinitor the status of the 16 
tcmltads. using a simple hit array, and ^ calletl remFlag. 

To adiie^'c the best perTormance, all the 16 lixal jcnittads hud Iti Ix^ in registers. 
Intermediate versions having only IE) to H icinitads in registers performed less than 
the all-in fegs one.To free as mucU registers as possible, the l>etectfl*nter function was 
tweeketi as much us possible: 

‘ since the pattern aiid mask Jiad mi padding mwlbtcs 
(lOwUy les was still a multiple of 2 of course, but not 
neeessarily of the internal pirs didn't necdetl 
intermediate line ptrs (they are used tm the Lefl/RiglU) 

- the line index of the mask/pattem is a float, usitig tite 

otherwise unused floating ]xiini unit of die processor, 

’ many' local variables were plueed as dumb parameters of 
die fuiK'tion (tile UuageDeicct calls use nilAI as the 
6 tirsi parameters) tt> fool the Powcrl^: (Compiler wliieh 
follows the l\iwcrP(; binary aRhitectnic for allocating 
parameters ami local variables. 

Many parameters were pul as staek parameters Ui order to free enoujdt fur the 
remRad's and tiihcr Inner ItJops variables. 

As a last note on ihb optimization issue, I warn to say' this vcrsioti of die code uses an 
if (ttntiBadxx) suiement before each xor/and t)n my PP€ 60 K this was less efficient 
than blind execution of the xor/atul Mowed by itie eliech to see if the rtmBad was 
now under D.On the PIHZ 601, im tests showed dial this veraitm was dster. probably 
due to one or both of the following factors: 

- branch predie ikm/excuiion is taster on the 6lM, 

the 60lWmory speed ratio being greater than with my 601, 
die load frum the gBitsOn array incurs a greater time 
penally than the time taken for branching. 

7 

r 

InitTargct 
InitTargei )o6& aie: 

to count the number of bits inside the pattern, 

• to build iUi array containing the mimbtT of bits to remove 
when the mask Is placed jXiriLally outside the 
haekgroundlmage, 

< to find how many wliite rows and cob are on the 
left/right/Uip/Lioiiom of the mask and squeeze the 
pattern and mask aecojriingty 
to make local copies of the paitem and mask that have no 
extra padding rowByies, 

■ to zeni any' mask bits on the right end of those rows if 
they are not a multipLc of 16 

Imagt'Detect dtiennines the nu mber of hid bits allowed with 
ik* nmse diresJiold then deiemiincs the number of rows must 
be tested on the top/bottom kirder It also st'ts s few 
globals about the locatkms. 

It then repeatciily calls lk-ieetLefi/G.-nter/RigJn hir the 
top It then calls the three functions once again tiir the 
middle {vertically speaking). Iinally, they ate called 
repraeiedly again m die bottom. 

V 

typedef unsigned shorlusbort: 
typedef unsigned long ulong: 

/* the gBiisOn array is m Ihe bilsOn.c- file w^hich must be linked into the pmjcei. V 
extorii unsigned char gBitsOn [^56'156) j 

r tiiobab 7 
Bit Hap g Pat tern; 

BitHsp gMflEk; 

ushorl gtnkWidth: 


SmalltalkAgents* 

Integrated Development Environment 
for 

Macintosh 
Windows 95/NT 


Check out what's new... 

www.SmalltalkAgents.com 


1405 Main Street 
P.O. Box 371478 
Montara.CA 94037-1478 USA 

e QuMAr XnovUiKjge S^»rr«.!«- Ift&Z 
WirKkiwi 9S srw! WiiKkows NT stb TradonariM of A^icrowfl- 


ufihort gfltkHoightt 
Point gmkSkip: 

Point ^gLocations; 

1ong gLoc a 11 0 nsCt; 
long gHaxToratIons: 

ulong gmkToLai Bits: 
ulong *gitikBitsCache; 

void initTargett 

BitHap pattern. ims^ lo be detected 

BitHap tuafik /* bits in image lhai wc 

)l 

long /•numFound7 lmageBetect( 

Bi iKap background Uage, /* find the largH imagt' in baekgrouudUiiage 7 

Foint locations], f return topljeft of matching locaiimis lierr V 

long naxLocat ions. f* max number of locations to return 7 

float nolne /* allow this fraction of mismutched bits 7 

); 

void Cl e a III U p (VO id k; /* dcidloeatc any memory allocated by in jtTargct 7 


IniiTurgct 

void InitTargetC 

BitHap pattern, T image to be detected V 

BitHap mask T hits in image liial wc cate about 7 

) 

( 

ulong mkEjiae: 
short height, width: 
aho r t minRowBy ta s: 
short lineldx. colldx: 

short inkTopSklp. tnkBorSkip. mkRightSkip. mkLeftSkip: 

Rect srcRnci. dastRecti 
ulong "mkBltsCache: 
ushort ‘rnkLinePtr, 'mkCurPtr: 
ulDQg bitsCtt 





7 

eaie about 7 
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Plr JtikBaseAddr: 

shtjil off Set; 


r CalciUating mask sire V 

width = maak.bounds, right - ma$k,bOimda.ieft; 
height mask.bounds-bottom ' mask.bounds,top; 

/* Minrminng rowByits and copying bitmaps structures 
and seniiig mask/patitm Uipldl to <0.0) 7 

minkowftytOH " ^ * ((width + 15) / 16); 
mkSize " height * tsinRowBytes: 
gKask-rowBytes rainRowBytes: 
gHask.bounds-top = D; 
gMaak.bounds,left = 0: 
gMask,hounds,bottom = helghl; 
gMask.hoimdfl,right - width; 

gMask.bsseAddr * NewPtr (nikSize): 
if (width % 16) 

\ t Zeroing liic list short of cadi row 7 
offset “ minkowBytES 2; 

(Ptr)iiikLinePtr * gHask.basuAddr + off Set; 
for (lineldx ’= 0: lineldx < height; line!dK++) 

I 

('siikLiiJOpir) * 0; 

(Ptr)BikiJjiePLr minRowBytes: 

1 

) 

CopyBttn(&mask, &gHask, 6mask.bounds, 

fkgKask.bounds, steCopy, oil); 

r idling lines cache, temoving empty ttip Lines and 
counting empty top Lines. 7 

(Ptr)mkBitsCache “ HewPlrCsSxeoffulong) * 
height * widlh); 
gnikBltBCache " mkBitsCache; 

(Ptr)mkLlnoFi r ^ gHask.baseAddr; 
bitsCt = 0; 
mkTopSkip “ 0; 

for (lineldx = 0; lincldx < height: llneldx++) 

[ 

if (mkBitfiCacha) 

inkBitGCnchR [ (litieldx - mkTopSkip) * width] “ 
bltsCt: 

mkCurPtr = mkLiriePlr; 

(Ptr)mkLinePtr += minRowBytes; 
for (: mkCurPtr < mkLincFtt; mkCurPtr+f) 
hitflCt +- gBitaOnl'nikCurPlr]; 
il (hi met — 0) 
aikTopSkip++; 

\ 

gmkTotalBits = bitsCi: 

r counting cmpiy btiuoni tines 7 
mkaotSkip - 0; 

lincTdx height * nkTopSklp 1: 

for (litioTdx - height - mkTopSkip - 1; {lincTdx > fl) 
(nkBiisCachefl ineldx * width] “ bitsCt); 
lineldx-) 

nikBotSkip++: 

height (inkTopSkip + mkBotSkip) : 

mkBannAddr “ gMaak.baseAddr + mkTopSkip * minRowBytes; 

r filling the bits cacheV 
if (gitikllitsCacho) 

( 

for (coildx = 1; colldx < width; colIdx++} 

I 

IIshort mkMask; 
ulojig freflBitsCt; 
short colHodulo; 

(Ftr)rakLiiiiePlr akflaseAdde + 

(heigtiL - 1) * mioRowBytes: 
mkLinePtr ^ (coildx 1] / 16 ; 
colModulo ^ (coildx ■ i) t 16; 
mk«aak - OxFFFF « (15 - colKodulo); 
frocBlteCt = 0; 

for (llncTdx height * 1; linelclx >= 0; 


freeBitsCt 

gBitsOn I (‘mkLinePtr) h mkHask]; 
bitnCt - freeBitsCt 


rakBitsCuchc [1 ineTdx * width + 
coildx 1 colModulo]; 
tnkBitsCacbellineldx ' width + coltdx] “ 
bitsCt; 

(Ptr)mkLinePtr aiinRowBytea: 

I 

I 

J 

/* calculating left and r^i empty coLs V 
mkLeftSkip = 0; 
lor (coildx ” 1; 

(coildx < width) 66 CnikBitsCachelcolIdK] ” 0); 
colIdx++) 

iiikL€ftSkip++; 
mkRightSkip = 0: 
for [coildx - width - 1; 

(coildx > 0) &6 (mkUltsCachc[colIdx| — bitsCt): 
colidx-^) 

mkRIghtSkipil; 

/* restructuring aildBit'k’iache accoitliug to the nc^^' widiti if it's smaller. 7 
if (CmkRightSkip + rakLeftSkip) > 0) 

( 

short oldWidth = width; 


width (mkRightSklp + mkLeftSkip): 
nrinRowflytes = 2 * ((width + 15) / 16); 


I 


for (lineldx = 0; llnoTdx ( height: lineldx'H-) 
for (coildx = 0; coildx i width; colldx+t) 
mkBitsCache[lineldx * widlh + coildx] * 
mkBitsCachellineidx * oldWidth + 
coildx + mkLeitSklp]; 


/* iniihliziug the paiicm BiiMap, ibc allmaied space 
will be used for mask or pauem data. 7 
gPattetn-rovBytes ^ atinHowBytes; 
gPauern.bounds,top * 0; 
gPattern.bounds,left 0; 
gP attern.bounds,bottntra = height: 
gPattern.bounds,rlghI * width: 
mkSixe “ minRowBytes * helRhi; 
gPnttern.baseAddr = NewPtr{aikSl^io); 

if ([mkTopSkip > 0) || (mkLeftSkip >0) || 
(minRuwByies < gMask,towBytes)) 

I /* I muM aropy the masl: bits V 
srcRect-top = mkTopSklp; 
srcRect.left mkLeftSkip; 
srcRoct,bottom “ mkTopSkip t height: 
srcRect-right - mkieftSkip + width; 
destReel.Top = 0; 
dentRect,left “ 0; 
destRect,hot torn '' height; 
destRect,right = width; 


tf (width % 16) 

\ /* Zumtring tLic Last sLiori of eadi rtiw */ 
offset = cninRowBytes 2; 

(Ptr)mt£LLnePtr ” gPattern, haseAddt ^ off Set; 
for (lineldx "" 0; lineldx < height; UiteTdx+<^) 
I 

(‘mkLineFtt) ^ 0; 

(Ptr) mkLinePtr +=■ miriRowByren; 


] 

GopyBlts(6gMssk, 6gPattern, 6srcRect. 6dontReCt, 
nreCopy. nil): 

r Nwitdjjng bits data tfcrwccn gMa.sk ami gPattem 7 
(Ptr)iiikLinePtr ^ gMnsk.baneAddr; 
gMasfk = gPattern; 

gPaT.tern,baseAddr - (Ptr)ittkLincPl r ; 


srcRect = paiiorti*hounds; 
srcRect-top mkTopSklp; 
srcRect.bottom -= mkBoLSklp; 
srcRect.left += mkLeftSkip; 
srcRect-right mkRightSklp; 

CopyBi rn(6pattern, 6gPattem, 6srcRcct, 

6gPattern,hounds. sreCopy, nil): 

gmkWitJth ^ width; 
gtnkHeight ^ height; 
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gmkSkip/v * inkTopSklp; 
gmkSkip.h ^ JukLeftSkipr 


tJcanlJp 

void ClcanUp(void) f tk-jlkn^ic mcfiicjrv- alloca^tfd by InitTaf^t't V 

I 

If (gPattern.baseAddr} 

DisposePt c(gPatte rn.baseAddr)j 

if {gMisk.baseAddr} 

DisposePtrtgMask.baseAddr); 

ir (gmkKUsCachc) 

DispoaoP t r ((P11J gitsklll i sCaclie] ; 


Boolean DetectLeft( 
Bitfiap' picture, 
long mnxBad. 
sborL lukRuwBytos, 
short pitRoiirBy tes, 
short picfop, 
short picTopLow, 
short mkTop, 
short inkBottoin, 
shorr itikWlrfrh)i 

Boolean l3etectCeiicer( 
ushort ’patCurPtr. 
ushori 'mkCurPtr, 
ushort 'pioLiuePtr* 
iishort *picGurPtr, 
ulong plcJ.ong, 
long dumbRcg, 
long ndcRowBytes, 
long picKDwByi;es. 
long lEikTop, 
long plcTop, 
long maxBad, 

1 ong picTopTHOw, 
long plcWldtb* 
long inkBattoBi* 

Ditl^ap* picture): 

Boolean DetectRight[ 
BitKap* picture* 
long tsaxBad, 
short mkHowByleSt 
short picKowBytes, 
short picTop * 
short picTopLow* 
short inkTop* 
short inkBottoin, 
short ptcWrdth, 
shorL oLkWidih]: 


InwgpDctctt 

long /* numpijund 7 ImageDetect£ 

a i tHa p ba c kg ro uii d 1 tna ge. F bnd iht laigti in backgrotiiid linage V 
Point 10 c a 11Q ns n . F Jttum itjpkh «f maahing ItJtHtions htit 7 

1 ong inajthocat tons, F max mimhor of IiitatMjns bi mium 7 

float noise F allow ihis frartion of bii>i 7 

) 

I 

ulong cnaxBadi 

short pieWidth* picHeight; 

ulong •mkBitaCarihe: 

Ghof t ftiklowBy tes: 

•jhon pieKowByiest 

short mkLine* outTop, oulBottorai 

long totalDitSi 

gLocations ^ locations: 

^ocatlonsCt = 0: 
gMaxLocations = mssLocations: 

if (gmkliltsCachc “ nil )/ainoot worit wiihovK tache V 
return 0: /*bui this could be paichi-il V 

if (noise < 0*0 || noise >= 1*0) 

return 0: /■ noi sup|j«M;d to hapixti 7 

if {gtakTotalBits == 0) 

return 0: F there b no bits in ilic mjusk 7 

naxRad * gmkTotalBits ' noise; 


picWldtb ' backgroundTmage*boimds.right - 
backgroundImage abounds.IcfL i 
picBeight * backgroundlmage.bounds*boLton 
backgroundImage-bounds.cop; 

if {(pieWidth < gmkWidth) II 
(picHeight. < gfnkHeight}) 
r c L urti 0; F noi suppisol to liappen 7 

takBitsCacbe = gaikBitsCacbe; 
takRowBytes ^ gMask. rowBytes: 
picRcwBytes batkgroundIiiage*rowBytes: 

F scan lop 7 
iiikLinc = I: 

while ((dkLinc < gmkBelght) hit 

(mkBitsCache [takLine * gmkWidthJ <= iiiaxBad)) 
nikLine++: 

for {outTop “ mkLine - 1; eutTop >=" it ontTop-) 

I 

if (DuieciLelil&backgroundTiiwge* ntaxBad* 
inkilovBy t e s * pic Ho wByt es. 
bac kgroundImage * bounds,top. 
backgroundImage.bounds.top + 1* 
autXop * gmkHeight, gmkWldth)) 
return ghncatlonflCt: 

If (OoloctCoutcrCnn, nl1* nil* nil* 0. 0* 
mkBowBytes. picRowBylos* outTop* 
backgtoundltnage, bounds * top * 
maxBad ‘ jnkBltsCache (outTop ‘ gmkWidthJ * 
backgroundloage,bounds*top + I, 
picWidth* gakHeight, &backgroundImage)) 
return gl*ocationsCt: 

if (OeteciRlght (AbarkgroundTinogPi* maxBad* 
xikRowBytes * picRowBy tes. 
backgroundIma ge * hounds.top, 
backgroundXoiage* bounds, top + 1* 
outTop* gmkHeight* pieWidth. gmkWidth}) 
return gLacatlonsCt: 

I 

F scan middk'kft 7 

if (Detectieft [ibackgroundimage* maxJiad* 
ikRowBytes. plcRowBytes, 
backg roundImage.bound s.top * 

backgroundlmage.bounds.bottom - gmkheight t 1, 

0* grakHeIgbt* gmkWidthJ) 
roLUrn gLocationsCt; 

F scan nikkllt center 7 

If (DetectCentertriil* pH. nil* nil* 0* 0* 
mkRowBytes, plcRowBytes * 0 * 
backgroundImage.bounds.top. maxBad, 
backgroundImage*bounds.bottom * gmkHeight t 1, 
pirWldfh. gmkHeight, fibackgroundImage)) 
rciurn ghocatIonnCt: 

F scan middle right 7 

if (BetectKightt&backgEQnudlittago* tnaxhad. 
mkRowJjytes * plcRowBytes. 
backgroundImage.bounds.top. 

hackgtoundImage,bounds * bottom ' gmkHeight +1. 

0. gfflkHfiight* plcWidth* gmkWldth)) 
return ghocatJonsCt: 

F scan iKJlhim 7 

tdtalBits “ gmkTotalBits: 
mkLine * 1; 

while ((mkLine < gmkBeigbt) hh ((gmkTotalBits - 
mkBltsCacheI(gmkHeight - mkLine) * gmkWidtb]) 
maxBad)) 

mkLlne++; 

for (outBottom ” 1; out Bottom < mkLine: oulBottora++) 

I 

if (DetectLeftCSbackgroundlmage, maxBad* 
mkRowBytes. picRowByte s, 

backgroundImage.bounds.bottom - gmkHeight + 
outBottom* 

backgroundImage*bounds *hot tom* 

0, gmkheight outBoUom, gmkWidth)) 
return gLocationsCt: 
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Build great applications... BeHer 

[ Great VGood'nufl ChBflpBF 

^ - ^ ^ f astBr! 

Tools Plus 


LIBRARIES + FRAMEWORK 


Make cool apps while others are sfill reading their manuals. 
Professionally polished. Wickedly fast Delfghtfully efficient.- 

^ TOutmes are more compact a fid faster 

r tlwn anylhiagyou might wnte...Every element 

of Tools Plus is osefuL ., a bargain t^omparvU 
with coding these n)atines yourself." 

You build the interface. 




Tools Plus provides the infrastructure. 

It makes all your pieces work logether as an application. 
With only a few hundred routines. Tools Plus thins your code 
by tens of thousands of lines. You see results sooner 
Changes are a snap. 

*'Ail in alb it^s an memdihty rub ajileciitm of tmds... 
if you are mterested In developing applications 
that have kjuahty' written all over them then 

Tttoh Plus IS lor you ' MacTech MAGAZINE 

Ybs, Tools Plus has it! 


if (DetectCentertfiil. nil. nil. nil. 0. 0. 

[iikR&¥By t e s. picK owB y t ee. 0. 
backgrotitidlmage.bdunds.bottom “ gmkHeight + 
otJtBottotfl, 

maitBad total Blt^ + 

rnkBltsCachetCgrakHoighi outHotlom) * gisktfiiithl, 
backgromidiinage.bDuncis.bottom. plcWidlh. 
gmkHeigbt - oytBottom. &backgroiU]dImHge]) 
return gLocatior^sCt; 

if (DeTectRightt&backgrouiidImage, maxBad. 
mkRowBytes, picRowBytes. 

ba ckg r Oil nd I mage, bound a, bottom - gnkHeight + 
outBottoin. 

backgroundlmage. bound s. bo L i otn * 

Oh gcakHeight - out But tom, picWldtb, gmkWidth)) 
return gLocatlansCt: 


return gLoeationsCt; 


Detectljeft 

Boolean DeteciLeftE 
BitHap* picture, 
long maxBad, 
short mkHowBytes, 
short. picRowBytes, 
fihoirt picTcp. 
short picTopLow, 
short mkTop, 
short mkBottom. 
short mkWidth) 

I 

usbori ‘plcBascPir. •picLfneFtr, ‘plcCurPtr; 
ushort 'patBaseFtr* ‘patLiiiePtr. 'paLCuiPtr: 
ushorr *3ikSaseFtrH ‘oikLinePtr, ■mkCurPtc, 

*mkEndQfLinePtr: 


C } 
[-“■t I 
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• Crealc any elemeni a single routine 

• hvcrylhiog work!i as soon as ycju crcfate it 

• Aiuionvales all sUindtrti GUI elumenis 

• Windows, Ttiol bar and floating pal^^tles 

• Buiions (all kinds, flat and ID) 

• Scroll bars ispeed trnnIroL live scrolling) 

• Wit)rld-class custom controls 

• Fioldb (w/scrojl bars, flltcirs, auio-ecilimg) 

• picture luiilons Olie best anyvtiiercl 

• List boKcs 

• CDEF and LDEF aotomaiion 

• Cursors (color, animated, aulo-chango) 

• Menus Epull-down, hierarchical, po|>upj 

• Edit menu (undd/retlo, automatic editing) 

• t\incls (ID, group boxes, lines, ixines) 

• iD lifles (raised or inset; 

• Extended multenviniior and color support 

• Clipboard automation 

• Dynamic alerls (no restiurccs rcc|urred} 

■ Event processing aulorriation 

• Over 500K uf custom fouls, icons, cursors, 
iuid nlhffr useful resources 




Plus Ihausands more exciting features and services! 


Results: 

Radical 
□ Slick 
0 Ravin* 



12 3 4 5 6 7 

Inset Panel Raised Panel - 


.qhort mklJne; 
uslsorl outLcftt 
ulong plcLong: 
ushort pieShift: 
long remBad; 
ushort mkoutl6s: 

for (iplcTop < picTopbowj pinToptt) 

I 

outLeft ^ 1r 
do 

I r caiculaiiiig rttiilkiiJ 7 

if t (mkTop) I [ // we re r>ui by tiH.* tup 

(mkBottom “ gmkHeight))//wr arc fully in 

// vedicjlly' 

remBad ^ maxBad 

gntkBitsCache[mkTop * mkWidib + qutLcI“]i 

else 

remBad - maxBad ' gnikTotalBita + 

grokBitsCachelnikBottocr. * nkiifidth outLeft] 
gffikaitsCachefoutLeft1: 


i£ {rcaBad < 0) 

break: // this causes die di>|| tn snip 

mkoutlbs " outLeft I l&j 
(PttJinkBasePtr - gHask. baseAddr + 

mkTop * mkRowBytes + mkoutl6s; 

(PtrlpatBanePtr = gPattern.baaRAddr I 

ffikTnp * jtikRowByT + itikoutlbfl; 
EPtrlpicBaaePtr = picture >b 3 acAddr + 

(plcTop picttice->boundB, top) ' picltowBy i oe ; 

pieShift - outLeft & OxOF; 


ijtfifl 

^UDI 


uperCDEFs 


*89 value 

i 1 / professionally dnsiRneil and crafted amiToH 
\ (^dozens of 3D & flat buttons, labs, sliders 

Toots Plus for 
Symaniec tTMlNK) mKi 

SI4*» 

IHINK & 1 niNK P^Bcat %m 

CrtdpWdOiw BriHlzc mSKI 5ITO 

CrtdiLWaniw Cnild (WUt .incf rtuvcrPLf $24** 

(Wfr.wtropi VISA iMiii-Ami'K iWIy, AAI I IQ. far Oiipfiinfj.) 

:jII AiirJKleinir. pHt ln|[ 


W4lH\ Fii(^ Siitiwarr 

2441 I Aeditw RomI WiMt, Ikn 711021, 

riiri^villv, DiitHnp rjrudj IM liMM 


Orden dod Enq 


Ptwnr:441»2ie-^S2S 
fax: I90S1 fl47 IS.ia 

yVbtorEdj(SWB*'aol. com 


Availalde 3 t our wd) site 
http://www. lnleflog.com/ - wn teredg 




Waters Edge Softvwatie 


/■ Icti liortJer matching 7 
if fpicSliiri) 

I 

tishort inkMaak; 

rakHask - OxFFFF » pieShift; 

mkLinePtr “ rnkBasePtr+t; 

parLinePtr = parBasePtriU 

picLincPir ^ picRasePtr++; 

toi (mkLine = mkTop; mkLlnc < iwkBoiiotnt 

iiikLirie++) 
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plcLong = *picLiiiePi:t; 

CPtr)picLlnePtr picRowByteu; 
romBad = gBitaOnl 

((•patiineFtr) (piEiLong >> picShiftJ) St 
{‘inkLineFtr} & mkMask] : 
CPtr)uikLinePtr += mkRowBytes; 

CPtr)patLiiiePtr t“ mkR^wBytes: 

1 

I 

If (rcim&ad < 0 ) 

conLitiue; 

C rcguLir paiitTn matclui^gV 

okLinePtr = mkBasePtr: 

(Ptr)iikEndOfLiEePtr * gMask, base Add r + 

CmkTop + 1) * mkRowBytes; 
paxLlnePtr = patBflRePt.ri 
picI-JncPif * ptcBaf,ePtrt 
/*for each line io Uic mask V 

for (akLine = mkTop» mkLine < [ikBottom; rnkLlrif^J 
I 

mkCurPtr - mkLinePtri 
patCurPtr = patLinePtr: 
pitGurPtr = pieLlnePtr; 
pickong •plcCurPtr++; 
if CpicShlft) 

I 

picLong «* 16: 
picLong 1“ •picCurPtr-H'^ 

J 

/* Itjf eajdi I6 n tbc atask insitk rhe iikt V 

for (i mkCurPtr < nikKndOn.tnfiPtr; wkCurPtr’H'J 

t 

remBad -= gBitsOn t(t *patCurPtr++) ^ 

IplcLong » plcShift)) St ('lukCurPtrlJ: 
picLong «“ 16: 
picLong 1^ *picCarPtr+-f; 

! 

If (rcmBad < 0) 
break; 

(Ptr)iiikLiaePtT +" nikHowBytes: 
(Ptr)iEkEiidOfLine?tr mkRowBytes: 
(Ptr)patLinePtr +- mkRowBytes; 

(PtrJpicLinePtr plcRowBytes; 

1 

If (tcinftad >= 0) 

( 

if (gLocationsCt < gHaslocations) 

[ 

gLocationsfglocationECtl.v “ 

picTop ’ rnkTop * gmkSkip.v; 
glocat ions [gkocritlonfiCt^H^] .H ” 

picture >boutids. Icf I oiitLcfL 
giakSkip.b: 

1 else 

return true; 

I 

1 while (++outLeft C akWidth); 


rcLyrn false: 

I 


jifdefine AddCenterLocatlonCrem, shift); \ 

if treni >“ 0) \ 

I \ 

if (gl.ocntionset < gKaxf^cat 1 tins) \ 

I j 

gLocationslgbocationsCt].V \ 

picTop - mkTop - gmkSkip.F; \ 

gl*ocations [gLoeationsCt++) tb = V 

picture*>boundfi.left + shift + \ 

(pieWidth - pieSeaiain) \ 

- gtiik5>kip*h: \ 

) else J 

return true; V 

1 


PcicciCcuier 

Boolean DetectCent€r( 
uahort •patCurPtr, 
ufihoft •mkCurPtr. 
ushort ’plcLinePtr, 


ushort *pieCurPtr. 
along picLong. 
long dunibReg. 
long rakKowayteSf 
long pieRowBytes, 
long KikTop> 
long picTop, 
long JnaxBad, 
long picTopLow, 
long picWidth» 
long TnkBottOJfi* 

BlLMap* picture 

f 

short picReiiain; 
float mkLineStart• 
float mkLine: 

(skLIncSurL = mkBottom rakTop 
picWldth = gmkWidtii; 

for {: picTop < picTopLow; picTop-H-J 

i 

picRemain “ plcWldth: 

do 

i 

iregister ushort teaiFlag: 
register long 

remBadOO. reraBad.Ql» reniBad02* retnliadOl, 
remfiadO^j, remBadOS. reoiBadOB* reinBad07, 
reiiifiadQ8« cemBadD^, remBadlO. remBadll. 
reinBadl2« retiiBadI3* remBadlA, remBadlS; 


/‘ initiRlking Ihc aniBatls and icmFlag V 
remFlag = QxFFFF: 

remBadOO * maxBad: remBadOl ' reoBadOO; 

rsmBad02 * reaBadOO; remBadOJ reoBadOl: 

reDiBad04 remBadOO; reaiBadOS ^ tedtBadiOl; 

remBedOft ^ romaedOO; remBad07 » reaBadOl; 

rctiEndOa ^ rcfnBadOO; rcntHad09 ramBadfll; 

remBadlO ” remBadOO; leatHadll ^ remBadOl; 

rGiiiBadl2 - remBadOO: remBadlO “ remhadOl: 

remBadl4 “ remBadOO; cemBadlS ^ remBadOl; 


switch 

j 

{pieRemaln) 


i 

case 

0: 

remBadOl ^ 

1; 

case 

1: 

remBadOZ = 

-1; 

case 

Z; 

remBad03 = 

'1; 

case 

3; 

remBadOA ^ 

’ 1 ; 

case 

4: 

remBadOS = 

■ 1 : 

case 

5! 

reutBadn6 = 

-1; 

case 

6; 

rctnBadt]? ” 

-l; 

case 

7: 

remBadOB “ 

1 ; 

case 

B; 

temBadOO = 

-1; 

case 

9: 

remBadlO = 

-l; 

case 

10: 

remBadll - 

-1; 

case 

11 ; 

rainEadlZ = 

- 1 : 

case 

12; 

remBadll = 

-1; 

case 

Hi 

remBadll = 

-1: 

case 

14: 

rcm8odl5 ^ 

J; 


I 

(Ptr)iiikCurFtr = 

gHask.baseAddr + mkTop ' mkRowBytes; 
tPtr)patCurFtr “ 

gPattern.baseAddr t mkTop * mkRowBytes; 

/■ regular pattern maichiOKV 

(Pt rJpIcLInePtr ^ picture->bafieAddr -t 

(picTop - picture >buui5dSH top) * plcRowBytos; 
picLinePtr += (picWldth picRemain) / 16: 


Aor eadi iine in the nmk */ 

for (mkLine = mkLineStart; mkLine > 0.0; mkLine-) 

I 

plcCurPtr " plcLlnnPtr: 

(PtripicLinePtr +* mkRawBytes: 
picLong ^ ‘picCurFtr++; 
r ku* cadi 16s of the mask */ 

for (: picCurFtr <= picLlnePtr; J 
I 

ulong mkLo, patLo; 
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StoneTable A Powerful Table Component 

You thought it was just a replacement for the List Manager ? We lied, it is much more ! 

Tired of always adding just one more feature to your LDEF or table code ? 

What do you need in your table ? 

adjustable columns or rows ? StoneTablet Publishing 

In-line editing of celi text ? Voice/FAX (503) 287-3424 

Tities for columns or rows? stack@teleport.com 

Color and styles ? 

Sorting ? 

More than 32K of data ? long the list is for StoneTable. 

Pictures and Icons and Checkboxes ? 1^°'® ^ ' http;//www.teleport.com/--stack 

More ?? 

How much longer does the list need to be to make it worth $200 of your time ? 

Make StoneTable part of your toolbox today 1 Only $200.00 MasterCard & Visa accepted. 


picLona It: 
picLon^ I* 'plcCurFtt-H-: 

nikLo - {*inkCiirPtr++); 
patio ^ (*patCut Ptr: 
fiwiLth (picRomaln) 

I 

default: 
case 15; 

If (reaiBadlS ( 0) 
r£?!nF1flg A= 0x7FFF: 

elae rcniBadt^ = gBitsOnf (patLo 
{picLong >> D) h mklo]: 

case 14; 

if (reiit3adl4 < 0) 

remFlag OxBFFF: 

else rei3!Badl4 -= gBitsOntfpatLo 
(plcLohg >> Z)) s mkLo); 

case 13; 

if (remHadn < 0 ) 
remFiag QkUFFF; 

else remBadlS gBitij0fj[(paLLa 

(ptclong » 3 )) & mkLuh 

case 12; 

if Um$adi2 < OJ 
rctnFlag k- OxEFFF; 
else r<MiiBadl2 gBitaOnTCpatLo 

tpicLorig » 4)) i mklc] : 

! 1 “ 

If (remBadU < 0) 
remFlag B- 0xF7FFi 

reniBadU -- gBltsOnUpatLo 
E pi dong >> 5}) B mkLo) : 

case 10; 

if (renifladlD < 0) 
remFlag &= axFBFF; 
else remBadlO = gBitsOnKpatlu 
(picLong » 6)3 fii mkLoJ; 

if (retiiBad09 < 0] 
rcraFlag OxFDFF; 

else reuBnd09 = gfiit-sOn [(patT^ 
tpicLong >> /)) h mkLo]: 

case 8; 

if {reraBadOB < 0} 
renFlag OxFEFF; 

elfje reitiBadOB = gSitsOnf (patLo 
(pidong » 8 )) fit mkLo] 1 


case 7; 

if EteiuBadO? < 0 ) 
rcEiiFlag h= 0jlFF?F; 
else remDadO/ - gHUjaOn! (patLo 
{picLong » 9)3 k niktu] ; 

case 6: 

If (reniBadOfi C 0) 
retiiFlag OxFFBF: 

else remBadOB = gR U ftfJn Upatio 
(picLong » 10}) k mkln]: 

case 5: 

if (remBad05 i 0) 

TRiiiFlag &“ OxFFOF; 
else roaiBadt>5 ■= gBitsOn 1 (patLo 
CpicLodg » 11}) ($ rakLol: 

case 4: 

if (remBad04 < 0} 
reaFlag OxFFEF; 

else reiiBad04 ^ gBits0n[(paiLo 
(pidong » 12)) k mkLo]: 

case 3; 

if (reoiBadOl < 0) 
reniFlag Sr= 0xfFF7i 
else remBadO^ “ gBlisDn[(patio 
(picLong >> 11)3 k mklo]: 

case 2: 

if (reinBadO^ i 0) 
remFlag h= OxFFFB: 
elso rcmBad02 -= gBitsOnf(patLo 
EpicLong >> 14)3 h fflkLol: 

case 1: 

It (remliadOl < 03 
remFlag OxFFFD: 
else remBadOl - gBltsOn[(patLo 
(picLcng » 153) k rakLo]: 

case 0; 

if CremBadOO i 0) 
remFlag k= OkFFFR: 
else remBadOO = gRI laOnI (patl-o 
(picLong » 16}) k mkLol: 

1 

1 

(Ftr)pldinePtr mkRcwBytes: 
(PtripicLinePtr +” pfcRoi^Bytes: 

if (reinFlag = 0) 
b reak; 

I 
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if (remFlag) 

I 

AddCenterLocatlonCcemBadOO. 0)r 
AiidCenterLucatlonUemBadOU 1) i 
AddCent^^rLoefltlon f rewiBadOJ , 2 ); 
AddCetiLurLoca LionfreBBadO'^, i 
AddCetiterLocation (i:<^iaBadOA, A): 
AddCenterLocatioii(remBiidOI?t S ); 
AddCenterLocatloa(remfladOb » 6); 
AddCentsrLocatioTj(remBad07» 7); 
AddCentetLoc4tloB{remBad08. B): 
AddCenterLocat 1 on { rantBadOS . 9) ^ 
AddCent Crimea ti on (reaiBad 10» 10} 
Add Ce ti i erLac a 11 on (re wEa d 11, 11} 
AddCenteri.ot:atlon(reiaEadl2, 12} 
AddCent^rLocation (retaBadll, 13) 
AddCenterLocation(r^mBad14, 14) 
AddCsnterLocation(remBadl&* 13) 
I 

picEcinuitn ■* lA: 
t while {plcKcinaJn >= 0} j 
I 

return false; 


DcuttRijdu 

Boo I oan Oetectit I ghr ( 

BitHiip* plciuro, 
long tnuxBad * 
short mkKowBytes. 
short picKowBytes* 
short picTop* 
short picTopLow, 
short mkTop, 
short mk&ottom, 
short pieWidth, 
short wktfidth) 
t 

ushort *picBaseFtr, 'picLineFtr. •picCutPlr; 
ushort *patBaseFtr, "patUoeFttr* •patCuiFtr; 
ushort 'lakBasePtr* •rakLinePtr* 'nikCutPtr. 

’mkKndOfUneFtr: 

shorL mkLlno; 
ushort out Right; 
ulong picLong; 
ushort picShlft: 
long temBad: 
uflhort mkautlfis: 
ushort nktotalIhs; 
ushori nkModuloi 
ushort plcKodulo: 
ushort flushModuIg; 

mkModulo * mkWidth A OxOF; 

^Ptr)TnkBasePtc - gMask-basoAddr + 

fflkTop * mkRowBytes: 

(Pt r)patEasePtr “ gPattorn^hassAddr 

nkTop ‘ itklovBytes; 
for (; picTop i picTopLow: picTop'H‘} 

f 

outRight 1: 
do 

I f* cakuJating rcmBad V 

\ f (CnikTop) 11 // out by the top 

(iiikBottora giiikReight))// wcarc ftdlyut 
// vertically 

rPtnBad - muxBad gmkTotalEi Ls + 

gmkBitsCacheKmkTop + 1} ' mkWidth 
outRighti * 

gmkBitsCache [nkTop * mktJidthJ; 

else 

remBad ^ maxBad - gadsTotalBits + 

gmkBilsCache[aikWidth ' mjtRight] + 
gmkBitsCachetmkBottom * takWidth] - 
gmkBitaCacha[CmkEottom +1) ' likyidth 
outRight] ; 

if (remBad < 0) 

break; // this causes the do{| to stop 



Your Total Bug Tracking Solution 


Powerful enougli to 
handle all your bug 
tracking needs. 
Affonlable enough to 
pul on everyone’s 
desktop, 


Introducing TestTrack 1.5 


and Solo Bug! 


Discover the tool more aini more of todays lop software developers are using 
to improve the quality of their Mac and Windows applications—^TestTncIi 


Tbark btig?, f^ure requests, o^itomar 
information, and more. 

Lbc on Mat or Window WKT plaifonm. 
Produce condse reports, 

Link engineers, testers, nunagprs, even tech 
writos. 

AuUimadcaliy route bujp to leam membcK. 


lime and improve lech support by 
giving Sole Bug, our stand-alone bug 
nponcT, in your customers (comes free 
Tfcith TkstTVack 15 ), 

Track ihe hl^ of each bug. 

Multiple users, full security! 
for consultants loo! 


To order call 513-683-6456 

Scapirte Software, liw. UJAb Scapinc Cl. MainettlJe, OH 45039 


sales@seaptne.com 4L ScapillC 

http://www.seapine.com Software 


/•setup V 

aiktnta,llhs = tinkWidth + 13) / lb; 
mkoutlAs “ (outRight + 

((rnkWidth ^ outRight 1 ) & OxOF)) / 16: 
(Ptr)plcEi?nePtr - picture->baB€Addr ^ 

(picTop - picture->boutids*top) * 
picRowRytnn; 

plcKodulc ^ pieWidth A OxOF; 
fiushKodulo = (adeWidth outRight} & OxOF: 
picShlft - fiushHodulo - plcHodulo: 
if (plcSMft < 0) 
pieShift +“ 16: 

/* right honttr matching 7 

if (CluishModulo > 0) 

t 

ulong mkHask; 

lakiinePtE * mkBasePtr + mktotailba - 
Emkoutlbs + 1); 

pni UtiRptr = patBasePtr + mktotallAs - 
(mkoiitlfjs I U: 

plcLinoPir ” plcBagePtr + (picWldth f 16 - 1); 
inkHssk “ Oxi'i'FF C’C (16 flushHodulo); 
for (aikLine “ jukTop: 

mkLine < rnkBottoia; iikhitie++) 

I 

pVf.Iong = *picLinePtr: 
plcLong «“ 16; 
if (pJcKodulo) 

picLoiig “ " (picLinoPtr + 1); 
picLong - piclioug picShlft; 

reinBad gBitsOnK (’patLinePtr) * picLong) 

& (•takLinePtr) & mkHaekJ; 

CPtr)tiikL1nfiPtr jakRowBytes: 

(PtrJ pat Line? tr +" mkRowBytefi; 
(Ftr)picLitiePu ^ picRowBytee; 

1 

I 
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If (reniBad < 0) 

CDftt inye; 

r Rcgubr paftern inatdilng 7 
mkLinePtr = rakyaael^tr: 
patLinePtr = patBasePtr: 

picLinaPtr = picBasePtr + (picWidth / 16J - 
(raktotallSs ‘ nLkoutlSs): 
mkEndOfllnaPtr ~ ifiklinaPtr f 

- inkoytl6s; 

if (fliisbModiilo) 
ijikJEndOfLinePLr-: 
r for each line to the mask V 

for (mkLine = nikTop: iikLine < mkBottom; inkLine-H-J 

\ 

mkCurPtr “ mkLlnePtr: 
patCurPtr = patLinePtr; 
pieCurPti = pieLinaPti:; 
pi dong ='pl cCu rPtr++ : 

if {pieShift) 

{ 

picLong «= 16; 
picLong 1^ ’picCurPtr++: 

J 

r each short in the mask Inside the plot 7 

for (: mkCurPtr ( mkfindClfLi nePtr; 

inkCurPtr++) 

[ 

reniBad -= gBitsOii[ ({‘ patCnrPtE++) ^ 

{plcLong >> pieShift)] 6 (‘mkCurPtr]J ; 
picLong <<“ 16: 
picLong 1“ ^pioCurPtr-H-; 

I 

if tremBad < 0) 

breaks 

(Ptr)mkLinePtr mkRowflytea; 

(Ptr)mkEridOfLinePtr += mkRowBytes: 

(Ptr)patLinePtr += mkRowBytes: 

(Ptr)picLinePtr i“ picRowBytes; 

I 

if (retoBad >= 0) 

I 

if (gLocationsCt < gMaxLocatlons) 

gLoc at i 0 n s 1 gio c a t i o nsCt J , v “ 

plcTop ^ tiikTop - gmkSkip.v; 
gLocatlonnfgLocationsCtff]*h = 

pictiire->bounds.right f oiitRight - 
mkVldLh gmkSkJpd: 

) else 

raturn true: 

) 

I while (++outRigbt < mkWidth): 

1 

return false: 


tiitsOnx 

/* 

an array of 65536 char gMng the number of I s 
in :mv l6 bit number 

V 


unsigned chargBite0ni256*256] “ 1 


Uri9,lgucij (.rXla.^ 
0. 1, 1, 2. 

1, 2. 2, 3, 1, 2, 

1 

2. 

3. 

2, 3. 3. 

4. 

1. 

2. 2. 3, 

2. 

3, 3. 

4, 2. 

3. 

3, 

4. 

3, 4. 4. 

5. 

1, 

2, 2. 3. 

2. 

3. 3, 

4. 2. 

3. 

3, 

4. 

3, 4. 4. 

5. 

2. 

3, 3. 4. 

a. 

4, 4. 

5. 3. 

4. 

4, 

5. 

4. 5. 5, 

6. 

1, 

2, 2. 3. 

2, 

3, 3, 

4. 2. 

3. 

3, 

4. 

3. 4. 4. 

5. 

2. 

3, 3. 4. 

3. 

4. 4. 

5. 3. 

4. 

4, 

5, 

4, 5. 5. 

6. 

2. 

3, 3. 4. 

3. 

4, 4. 

5. 3, 

4. 

4. 

5. 

4, 5. 5. 

6. 

3. 

4, 4. 5. 

4. 

5, 5. 

6. 4. 

5. 

5. 

6. 
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7. 

1. 

2. 2, 3. 

2, 

3. 3. 
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3. 

3. 

4. 

3, 4, 4. 

5, 

2, 

3. 3. 4. 

3. 

4. 4. 

5. 3, 

4. 

4. 

5, 

4, 5, 5. 
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2, 
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3, 

4. 4. 

5, 3, 

4. 

4. 

5. 

4, 5. 5. 

6. 

3. 

4. 4. 5. 

4. 

5. 5. 

6. 4. 

5. 

5. 

6. 

5, 6. 6. 

7. 

2. 

3. 3. 4. 

3, 

4. 4. 

5, 3, 

4. 

4. 

5, 

4, 5, 5. 

6. 

3. 

4. 4. 5. 

4. 

5. 5. 

6. 4. 

5. 

5. 

6. 
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7, 

3. 
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4, 

5. 5. 
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5. 

5. 
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4. 

5. 5. 6, 

5. 

6. 6. 
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6, 

6. 

7, 
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a. 

a. 
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2. 

3, 3. 

4. 2. 

3. 

3. 

4. 

3, 4. 4, 
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r 

[ you get the idea ... most of the rest deleted 1 
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11,12.12.13.12.13.13,14.12,13,13.14/13,14,14,15, 

3. 9, 9,10. 9.10.10.11, 9,10,10,11.10,11.11.12, 

9.10.10.11.10.11.11.12.10.11.11.12.11.12.12.13. 
9,10,10.11,10.11,11.12.10.11,11,12.11,12,U,13, 

to,11.11.12,11.12.12,(3.11,12,12.13.12.13.11,14, 

9.10.10.11.10.11.11.12.10.11.11.12.11.12.12.13. 

10.11.11.12.11.12.12.13.11.12.12.13.12.13.13.14. 

10.11.11.12.11.12.12.13.11.12.12.13.12.13.13.14. 

11.12.12.13.12.13.13.14.12.13.13.14.13.14.14.15. 

9.10.10.11.10.11.11.12.10.11.11.12.11.12.12.13. 

10.11.11.12.11.12.12.13.11.12.12.13.12.13.13.14, 

10.11.11.12.11.12.12.13.11.12.12.13.12.13.13.14, 

11.12.12.13.12.13.13.14.12.13.13.14.13.14.14.15, 

10.11.11.12.11.12.12.13.11.12.12.13.12.13.13.14, 

11.12.12.13.12.13.13.14.12.13.13.14.13.14.14.15, 

11.12.12.13.12.13.13.14.12.13.13.14.13.14.14.15, 
12,13,13.14.13.14,14,15.13,14.14,15.14.15.15.16 
1; 

in 


Help Make MacTech Work 


Hca at MacTech Miigazim, wc rciy hciivily on 
outside writers for most of the m;derial that 
nppeiffs in our pa^^es. If lejiders did not 
piftidfxiie in die rnngiizine, sending us ihdf 
itieiis nnti inking tlie lime to write :i nicies, I fieri" 
would Ix^ no MmiTecb. MacTt^'h Ls 

rxd a staff of writers sending a constant stn^ain 
of one-way messages oiitwaitLs; it’s a living, 
evolving network of nxiders t'onveiTJing wifli 
one another, educating one another, sharing 
tlieir knowledge, tlieir experience, tlieir uiterest, 
their trials and tribulations and joys and 
sitccesscs in the coashintly unfolding story of 
programming the Macintosh, MacTccb 

Maficizim doesn't hi^ppen; ifs wiiai the 
community makes it. If we tarry reports (>f 
future irentis and leduiolpgies, ii' we teach 


useful medioils, if we review new^ books anti 
tools, if we provoke thortglit. provide help, ride 
wave of current interests and concerns, it Is 
only Ixxausc wc Reflect the thouglits of our 
Raders, w'ho spciik itmiugli our pages. 

You invited to involve yourself in 
this exciting conver'sation amongst readers. 
No tiiimer wIk) you are. no matter what yemr 
tTetlenlials may lx*, if you have a tale to tell, 
a rnck to share, a technique to teach, we 
want you to consider joining the family of 
those who wmte for MacTech. 

Don’t just wait for a topic to lx? covered 
OT a technique explained in MacTechf Take 
re,sponsibility! Write us an article yourself) 
'lb write for MacYixb, just send for our 
Writer's Kit, It’s a Microsoft Word file 


eontaining the Styles you need to use. and 
giving lot,s of helpful advice and inlbrmalion. 
including all the legitl stuff. You can lel us 
know wkn youVe writing alxiut, or, if you 
want tOj you can just write the article and 
spring it on us when ids dune. [Note; We 
also have a need for peo[>le willing to make 
theni-selves available to write occasional 
product/h)ok reviews.] If we publisli your 
article, you’ll lie paid for it! 

WVite to u,s, the editorial staff, at 
editorial^^inacteeh.com (or one of the other 
addresses listed on page 2 of the magazine), 
'I'ake die fufure of Maclixh Magazine into 
your tmn hands! 
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A Brief Look at Two Btx>KS About Pfjuj 
“Learning Pert” and “Pert 5 for Ditmmtf 5” 

hy Paul A. Coliins, Ona Click Systems 

Oktiy, Perl iioay noi l)c ihe first lan^uLige lliiU t:onies to mind 
when yon think of Macintosli softwate development. Yet its )x>werfi.il 
text-proc^essing abilities and noiioasense syntax make i^ed a very 
usehil language to know, li suppoits OOP, is handy fora ontMime 
app to convert a file, is ''write-once, ain-aiitiost-any where” today, and 
can lie jndispensahle for web server CGis on any platfomi. 

Foitunately, there is an ext'elleni Macintosh implementation of 
Perl 3, MaePerfi [XJited by Mattlims Neemcher (Perl was created by 
Liiry Wall), It even includes a standard file dbilog module for your 
<i(Kumenl handling convenience. Beyond nmning Perl apps on a 
Mac, it makes a gcxKl development platfonii for creating CGIs and 
otlier apps iniendetl to run on, say, a lJ>{ix-l’>ased web site. MacPerl 
even has some suppcjn foi- AppleStjipt and XCMDs. 

To get you started, two gocjd Perl tutorial IxKjks are 
Learning Perl by Randal L. Schwadz and Tom Chiistiansen and 
— no kidding— Perl 5 for Dummies by Paul P. Hoffman. 

Learning Perl (a.k.tL The Llama l^jok) eonLiins the hesi 
chapter-lengtli iutnKluction to a langttage five ever seen, Widiin 30 
pages I fch 1 knew just what the language was about and of 
wdiat I needed to write a dozen differeni apps. IL starts with a one- 
line “Hello World” tlien builds it up little-by-littJc into a BO-lmc 
logiivand-guess-the-seaet-word datalxise system, introducing the 
major concepts of Perl by example. 'Hie writing style is concise bur 
complclc. In 269 pages ilicy cover language struaurc* and syntax, 
I/O, regular expressions, files and directories, databases, and text 
formats. The second edition adds a diapter on CGJ programming. 
Many rcfeiences are matle to UNtx functions and convtrnt ions, but 
they are clear enougli to l:!e undeistood without knowing Unix, 

Programming Perl, available from the same publisher, is 
more advanced, c:omprehensive — a language referem'e — and 
one huge hook. It is very higlily regarded, but 1 iiavcn’t needed 
it (or my CGI projects. 


Perl 5 for Dummies is surprisingly intelligent, The 
"pn)granIIiiing-ibr-non-programmers” parts are easy to skip over, 
and I loffman clearly dexuments detailed aspeGs of the language 
witliout lieing too cute. 1he intrciduction to reguLir expressions 
(prol>ably the most complex, bewildering, yet powerful part of 
Pei l) is understandalde after a couple of readings — high praise 
for any tlescjiption of this arcane syntax. 

Hoffman covers MiK'Perl installation, advantages, and 
differences from other Peris — and lie writes like a Mac user. 
Mac topics include “MacFeri: The Mac Interface You Expect,” 
“Opening files is more fun on the Mat ,” and “Controlling a Mac 
with MaePerr (covering Mac'.specifie file and other funeiions). 
“I’en Really Short, Really Useful Perl Programs” contaitis some 
gems. “Tlie Greal Perl Reference” almost lives up to its name. 
The alphabetiaii [unction list is fine, [)uL the list by chapter 
sh(juld have specified categories and [>age numbers. Don't miss 
his “Ten Reas<ins Why Perl is Bener Than java.” 

Perl 5 for Dummies is 3H1 pages and intiude.s a CD ROM 
containing MacPerl v5. 10r2 (as well as Unix and Win32 versit>iis), 
plus die CPAN .script library (as of December *96). CPAN is a huge 
FTl^ lilirary of Perl modules and objects From ar<mnd the world, 

Tliere are many ustx,‘cts of Perl these inlrcxlLiclory iKXjks don’t 
cover, but by the time youVe mastered either or lx)th of them you 
can rely on Perfs exten.sive on-line documentation. This is 
available in “POiy (Plain Old Docu mentation) fonnai on the Perl 
3 for Dummies CD and otlier fonnats aie available by FIT 
(including html). Unfortunately, Shuck, the POD reader bundled 
with MacPerl, crashed several limes under Mac OS 8, Mac OS 8 
users will have to download the documentation in another fonnat. 

imLs 

MacPerl is available on many CPAN FTP sites. For a list, see 
the MacPerl Homepage <hTlp://err.ethz.di/-neeri/mac]ntosh/perlhtm!> 
Of the CPAN/ports directory^ <http://language,peri.com/CPAN/ports/>. 
Documentation in HT ML and other foniiats can lie downloaded 
from <hllp://language.perl,com/info/documentation .html>. 


Paul A- CoUms <paul^^onedick.com>, owner of One Click Systems, w'uuki like to finish up die PeHTiascd sales-and-tkiwnload section of fii.s web site 
and get back to eniiancing his eoniinereial email gateway, CTickMail® <httpi//\vwu'.onedickxom/>, 

MkhaeJ Kulinan <inot>se@inamcTii(xxse tom> Ls a sofiwam developer with experience developing for scwml plaitbmis, including Macintosh, NeXTSTKi^, 
Newtoa Pilot, luicl Windows NX While worldng at Software Ventures, lie lead tlie developtnent of Sn:itdier and MiooPlione Pro for NeXTSTEl^ He also worked 
on the Microphone Pn> for Macinrash prtxliicr tine. He now works as an iiide|iendnnt oinsuiiant on a vanety of pn jjet ts including encryption, compilers, web 
l.vaseti adthioiation software, and sliip stevedoring. 
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Books 

• i^irning Perl, Settint! Edition by Randal L. Schwartz and Tom 
Christiansen, July 1997, O'Reilly & Associates, Inc,, ISBN: 1- 
56'>92-284-0, 

• Perl 5 For Dummies by Paul E. Hoffman, 1997, IDG Btx)ks 
Worldwide, Inc., ISBN: 0-7645-(X>44-9. 

Lyn Dupre’s “BUGS in Writing” 

hy Michaei Rut man, independani comuhant 

Not that long ago, my writing was awl'uL No matter how 
hard T struggled, my niemos and internal documents were 
difficult to read. I twk a rhetoric course in college, and 1 have 
read the rhetoric manuals, and other guides on style, but they 
never helped. IVe had documentation pcxrple try to work witli 
me, hut they could never explain w^hat 1 was doing wrf>ng. 
Fortunately, 1 w^as paid to write code, not memos, sr> nothing was 
said. Then 1 read Lyn Dupre's lKx>k, and in two weeks, iny 
writing was vastly improved. Tlie current editor of Mac'Iech, who 
w'orked with me before 1 read Bugs in Writing, was sh(K:ked tlmt 
my writing could improve that much in cmiy 2 weeks. 

Most lxK>ks on pro.se seem to l>e aiithoied by jx^ople who 
have never written a bad sentence in their life. While it is great 
that they know their topic, it doesn't work for me. 1 always feel 
out of my depth, and their examples never click in my mind. Lyn 
Dupre, on the other hand, feels that computer jieople need their 
lessons in a different way. Iniponantly is an adverb, and yon 
should use it as such, to modify a verb. It means to take a given 
action in an important manner 

In her Ixxok. she Fonmts each lesson in 1 to 5 pages. lessons 
can lx* read in any order, and all of them are short enough lluit 
leiiving the hxxik in the lxuhrcx)m works well. liich lesson irK’ludes 
gcxxJ and bad exam]>les By showing a bad example next to a gtxxl 
example, a^adets can see ejatdiy what is meant. 

For example, in lesson 101, the lKx>k discmses the word 
im/fortantiy 


Many people write importandy (xin activity modifier, or 
an adverb) when they mean fmfxjr£ant (an object 
modifier, or an adjectitJei. You .sht^uld tune your ear to 
catch tliis error, l>ecaLise a portion of your audience will 
find tlie mistake intensely annoying. 

RAD: Importantly, the algorithm cannot hancQe situations 
wiUi a large state space. 

GOOD: ^arah walked imporumily in her cheetah l>athing suit. 
Important is the word that you should use in all other cases. 
BAD: Importantly, Max forgot to shut die door w^hen he left 
the house, resulting in an influx of racoons. 

GOOD: Most important, reniember to provide fresh food and 
water, and mucit pelting, for your cats. 

"ITiis lesson actually has 15 examples. In addition, tlierc am 
3 f(K>tnotes mentioning oilier points to help readers understand 
what makes one word gtxxl and another had. Some of her 
examples are teclinicaily correct, but ugly. Whenever she uses an 
ugly example, she explains wliy it is ugly and liow' to avoid ugly 
fjLit technically conxxl plirases. 

My favorite parts of this hook are the examples. Many 
examples Involve computers, but I hey also involve her pets and 
friencLs, While I am sure they are ct>ntrived, they at least sound 
like sentences 1 would write. 

Other lessons include corrtxi use of the words ‘'since,” 
'al.so," ^either" and ‘ixHh." “only," and many others. She also 
talks about adverbs and adjectives, full and incomplete 
infinitives, nonarriving agents, and just ahout any olher topic you 
can think of. Not all of the lessons are on words, some are on 
overall style. For exanif^le, she talks alxjut how to write 
[)ro]>osals, abstracts, disseruilions. and also deals with writers' 
block. If there Is any failing of the hfx)k, it Ls the lack of an index. 

For anyone that w^ant.*^ to be under.stcxxl when they wxite, 1 
recommend yt>u go out anti get this ixxik ftKluy. 

• BUGS in Writing, by Lyn Dupre. 1995, Addison-Wesley 
Publishing Oimirany, ISBN: 0-201-fifX)19-(). B 


Dilbert" hy Scoll Adams 



BUT ILL RAISE TOUR 
APPR/MSAL TD 
'EtCEUENT* IF TW/LL 1 
EAT A &06. 





^ 1 DIDN'T HAVE nUCrt A 

LOCK WrTHTHEamER 
hANAGEAENT TECK- 
MIQUES 50 rn KINOA 
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OniLIME 



by Nicholas C, ''nickx^'DeMello <onHne®mactecbxom> 



Soft Wear 

Wlit.'n iULnix>wcTks brought us CcxleWurrior they did it with 
the same kind of outrageous style and unwavering commitment 
tliiit launched a hammer across a room full of l*Cs. To helf) 
celeliraie the CodcWanior in eacli of us, metrowexks lias 
intnjdiiced Geekware, Geekware is clothing for the 
discriminating programmer: T-shirts, hats, sweatshirts, and 
underwear. Yes: underwear For le.ss llian $20 nietrowerks sells 
a pair of boxer shorts with glow' in the dark bugs and a fcxit 
about to stamp them out. No this isn’t high fashurn, but I 
guarantee that it will make a memorable olTicc gift for your 
favorite QA ]>crson. Visit metrowerks web site to check out 
piciures (with the light on and off) of the debug boxers anti the 
full tine of Geekware. You can fiurcliasc^ Geekware directly 
from iuetrowerLs, or from the Develo[>er Depot (purv^eyors of 
a varienty' of very kcxil developer supplies) 

Geekware should not Ixt confirst^d with other brands of high 
([ualiiy geek apparel, like GeekGeer and Geek Garb. I'he 
GeekGeer web site offers GeekGeer logo baselsall caps, t-shirts, 
and pocket prelectors, w^hile Geek Garli is an all i-shirt 
extravagani^a. Geek Garl> will even ixrsonalLse T& with your LUtL 
for an additional $3 (on top of their low $B-15 prices), 

Metrowerk^s Geekware 
<ht^://www,metrowerks.com^prDdijct$/geekvvare/> 

The Developer Depot 
<http://WWW. devdepot. com^> 

GeekGeer 

< http://WWW, geekgeer, com/> 

Geek Garb, award witining T's 
<ht 1 p;//www.geekgarb.a)m/> 

Raise the Flag 

Macintosh isn't a platform, it's a lifestyle. 'The Apple 
Designs website hosts a collection of over SO Apple 
memorabilia products. Things that caught my eye were a $9 
A[)plc coffee mug, a $20 Apple logo Swiss-arniy knife, a $40 
Apple watch, and a $6S Apple desktop ''Lava-Lamp'' dock. 
There is even a quicktime VR movie of the lava lamp (I gotta 
get one of these Oh, and if your friend already has a Swiss 
army knife, check out the "Moof!” t-shirt: every die-hard Mac- 
o-phiie should have one. 

Those satne die-liard Mac addicis need to stock up at ilie 
Mac Sofshop. With sharp looking $15.95 i-shirts that sport 
fighting logos like "Real Designers Don't Do Windows'* and 
"The Only Good PC, is a PowerPC*’ die surfshop looks like 
Guy Kawasaki invaded Local Motion. While online at the 
surtshop I ordered a copy of their $4.95 “Fight Back, for Mac!" 
poster for my office and a handful of $2.95 bumper stickers to 
pass out to friends (half the fun of X-inas shopping is picking 
up a few treats For yourself 


The worlds largest Mac user group, the Berkeley 
Macintosh Users Group has their winter catalog online. 
Rveryone has a friend who needs either a little help 
understanding the voodoo that is SCSI, or installing ram. If 
you're not always around to offer iliat helf) and advice, give 
your friend the $.39 BMIIG vStarler Kit. The starter kit includes 
a copy of the BMUG public domain software CD and 6 months 
of access to the BMUG help line. Other hilighis of the F^MUG 
Winter catalog include the Mac Bathnjoin Reader for $11 (a 
very kool book of Macintosh trivia — if you know everything 
in this hook, you need a life the RMLIG Foni colleciicai CD 
ROM for $24 (over 1,700 tlislintl 'True'Type and Postscript 
fonts); and Macworld Expo t-shirts from the Japan, Paris, 
Boston, or San Francisco events for SR each. 

Apple Designs 

<h ttp://www. a ppledesi^i tDm/> 

The Mac Surfshop 
<htlp://WWW. macsui lsliop.com/> 

Qerkely Macintosh Users Group 

< ht Ip://WWW. b mug. org/Products/> 

Gifts Across Piafforms 

By now you should luive a gift for just about ev^eryone at your 
oFRcTe. Except maylie for tliat stnmge guy in the next ( uhit le — the 
one .still using windows. liieru is even liofK^ for hinu Dillx:rt is 
c:ii£)ss plaifomi. Tlie DillxTl Store web site lias offers $19.95 Dogheit 
plush ctolls (tlie ideal office comptinion), B)98 Dilbeit desk calencLirs 
for $12.*}5, nine web pages of $ 18 1 -shirts and $29.50 polo shins, f>las 
the $39.95 Dillx-m Tiift Tin*' (a ^>110111011 of Di]l>eit menwrabilLi that 
Ls a 10(]% improvement over the average Chiistnus amiy tin). 

If your friend already has Dt^lren sitting on his monitor, 
infrcxluce him to the Geek Gtiaalians Auda and Yada. TTiese 
|x>tt'clain figurines from the Geeque Ifoutique are spetifiailly 
designed to balance on computer monitors and promi.se to pn>ieci 
your computer data for only $12.95 e^icb (much cheafser tiian die 
average dtia recovery service 

Dilbert 

< h T t p://w ww.un ft&dmedia.com/comi cs/di I beii/> 

The Dilbert Store 

<hlt p: //WWW. un i ted media, cQm/5tore/> 

Geeque Boutique 

< http://www.everytN ng-gee k.cOT/> 

Have a good Christmas folks, well see you in January 
when .Macl'ech Online takes a closer hH>k at the new year and 
the new OS: Rhapsody. 

'Ifiese and other links are available from ilic MacTcch 
Online web pages <http://www.mactech,com/online/>, H 
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by Jessica Couriney 



Denkba Adds Web Design CAPABnmE^s 
TD Canvas with Cdlada 

Web-publishing; ttH>l t« debut in Canvas 5.0-5 update 

Dcncbii Software announced ihai it is s(lipping Colada, 
its new web page authoring plug-in tool for Canvas 5. Colada, 
which is Java based, allows Canvas 5 users to create pixel- 
perfect Internet pages (juickly and easily. Colada empfiasizcs 
ease-of-use, instant access to Canvas 5's robust features, 
effortless previewing capabilities, and functionality as its 
underlying strengths. 

Canvas 5 users are invited to download Colada from die 
company’s web-stte. Deneba is featuring Colada in its Canvas 
5.0.3 vipdaie which is shipping free of charge to all regisiered 
("anvas users, 

Colada is a one-step solution for creating visually appealing, 
imricafe w^eb pages within Canvas 5. J'here is no need to learn 
HTML tiode with Colada. batrh web page is auLonialically saved 
using i:>oth Java applets and HTML code, Colada oiierates on 
both Mac OS and Windows platfomis, Colada is compatible with 
all mexiern browsers enabling users to view web pages with or 
without Java support. 

Since all page design takes place within Canvas, there is a 
short learning curve. URL management is Ixith simple and 
intuitive. Hyperlinks ean assigned to any object l>y simply 
accessing the URL ctimmand and URL attachment palette, 
Assigned hypeilinked objects can contain links to pages within a 
Canvas ptihlieatinn, to traditional HI.ML pages, or to externa] 
links at remote web sites. 

Canvas useis can link http, ftp, and niuilto URL tags to any 
object or text seieefion in Canvas 5. Users can apply any colons 
and text styles to hypcTlinked text. The URL attachment palette 
also allows users to find objects that have a specified URL 
a.ssigned to them and remove the VRl a.ssigned to any object or 
text .selection, Colada users can even chcxise URi, prefixes {text 
at the beginning of Intcmei addresses) in order tcj quickly assign 
web, ftp, and e-niihi addre.sses from the |^)p-up menu. 
<hTtp://www,deneba.com/> 

Digital Alchlaiy Ufgradls Mlkcltio MDEF 
TO Support Mac OS 8 

Digital Alchemy aniifxmced the release c>f the Mercutio 
MDEF version 13A. Tlie Mercutio MDEF is a Menu DEFinkion 
re,source that allow develoj^ers to easily extend the power of 
their application menus, Mercutio allow menu items to have 
niulLtple-modificr key-et|uivalents (e,g shift-command-CX 
custom icons, item callbacks, and other goodies, Mercutio menus 
may also contain \lynamic menu items” that allow a single menu 


item to change depending on what modifiers are held down. 
Dynamic menu items keep menus short while allowing the 
flexibility of keyboard shortcuts. 

Version 1.3^4 adds compatibility with Mac OS tile 
Appeamnee Manager (including Platinum Theme), improves 
compatibility with Kaleidoscope, and fixes a number of bugs, 
Mercutio works under System 6, System 7, and Mac OS 8, and 
diKiH not rc‘([uire any external system extensions. Mercutio can Ix" 
downloaded from the Digital Alchemy web site, 

I’he documentation for Mercutio follows the style of Apple's 
""Inside Macintosir manuals, and i,s in Adolie’s Acroixtt format. 

Developers may use Mercutio fiee of charge as long as they 
include certain credits in the About box and documentation, and 
supply f)igital Alchemy with a copy of llie final progmm 
(including future upgrades for as long as the software uses 
Mercutio.) See “Mercutio Software License.pdf’ for details on 
terms of use. Other licensing terms are available. 
<http://www.digitalalchemy.com/mercutio/> 

Stagecast to Bring Appije’s Cocoa Technology to Market 

Startup licenses Proven Aiithoring Technology for Kids 

Stagecast Software, Inc,, a K-12 software company, 
announced that it will develop commercial prcxiiicts based on 
Apple Computer Inc.’s Cocoa tedmokjgy. Due to recent changes 
at Apple, the computer company disccintinued commercial 
development of Cocoa, 

Members o( tfie original Apple development team formed 
Stagecast to further their dream of creating a product line that 
takes advantage of the simple graphical programming technology 
first demonstrateii in C(Kx>a. 

Coe<)a is an authoring tool and ]>layer for desktop and wel> 
ha.seci children's s()ftware. Apple Computer currently distributes 
a research prototype of the software tool. Apple’s latest design 
release of Cocoa for the Mac OS^ version D1L2, lias Ixen available 
as a free, unsupported j^rototype frcjm Apple's website since July 
1997, Ver.sion 01(2 is now available for free download from 
STageca,sFs web site, and from Apple’s well site, 
<http://www,stagecast,com> 

<hltp://cocoa.apple,com> 
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OpenB^vsk LriE Friie 

OpL'nfJaNc fniernutional, ltd announced that it is providin^^ 
a single user version of its p<)piilar OpenBase SQL diitahase 
FHEH on Windows NT and Apple's next genenttion OS, c<xle 
named Rhapsody. ’I'he FRHH deployment license, called 
OpenBase Lite, allows single user applications to access local 
databases. Multi-user Ojxrtinasc Network licenses which are 
100% compatible with the free license are available lor purchase. 

OjvnBase is a high performance SQL engine that handles 
all of the coinplexilies of data storage and miilri-user 
t:ommunicarion for end-user applications. Aggre.ssive fiiulii- 
threading, row^ level locking, text searching, change notificaliori 
and variable record length Leclinology makes OpenBase a robust 
database solution. 

OpeiiBase Lite 

OpenBase Lite provides a zero administration tblabase 
interface. An FQK adaptor is included. 

OpenBase Network 

OpenBase Network provides high perfomiance and 
unparalleled ease of ust^ Along with support for the latest 
object-oriented twls, including Enterprise Objects Framework 
and WebObjects. OpenBase Network offers graphical tools for 
designing cLilabase schemxLs, managing user access and viewing 
database information. ODBC and Java support is available. 
<http://www.openbasexom> 

Neon Software’s NetMinder Ethernet 4 A 

Neon Software announced an upgrade to NctMinder 
Ethernet version 4.0, their sofTware-oidy network ()rokK‘ol 
analyzer. Version 4.1 atJdresses key needs created by the latest 
Mac OS system and Eihemci hardware. 

Running native on any Macintosh or Power Macinujsh 
cquip|x.xi with a supported 10 or 100 Megabit Ethernet interface, 
NeiMinder Etheniel captures and decodes a full range of 
Ethernet protocols. In addition to NctMinder ELhernet's original 
features, such as l^acket Inference, which automalically detects 
and recommends solutions f<ir many types of Ethernet network 
problems, and Packet Explain, which provides protocol 
descriptions for all packet types decoded, NctMinder ELhernt‘1 
allows the user lo do packet hltering, post-filtering, and 
triggering, features previously ffsund only in very expensive 
hardware-based analyzers. 

NctMinder Ethernet 4.0 registered users may upgrade ITIEE 
to version 4.1 from Neon Software's w'ebsite. Registered users of 
NetMinder Ethernet 1, 2 or 3 may upgrade to version 4.t for only 
$99 until December 51st. 1997. 

<http://www.neon.com/> 

Fantasm 5 

Ligiiisofi announced the release of the demo of Faniusni 3, 
a Macintosh assetnbly language development environment. 
Fanta.sni 5 is a major upgrade produced over the last two years. 


'Utis release addresses four major areas: 

• Flexibility 

• Ease of use 

• Speed 

• Mfxiularity’ 

Fanta.sm 5 Is designed to allow the creation of most any 
kintl of high speed Mac application, code restturce, fragment, 
control panel, extension, shared library^ etc. Ako useful for 
accelerating higher level C ancl Pa sen I projects. 

It lias a new grapliical project manager which allows the 
use of multiple open projects, embedded projects and merged 
Largeis. IL provides a new plug in architecture with publically 
availaltle API It‘s up lo 2604fj faster liian the version it replaces 
and uses processor emulation to S[>ot pipeline stalls and 
dcfiendencies in your .source code milking it easy to pixxtuce 
very higli s|K*ed ctKle. 

<http://www.lau.it/lightsoft> 

BBEurr lNTF.<iRAms wtth Macromedia Tool 

Bare Bones Softw^are, Inc. today announced their 
panicipation in a collaboration with Macromedia, Inc. to 
fmivide high-technology Web authoring tools. As the result of 
this effort, BBEdit, the premier text and HTML editor for the 
M:u' OS, will integrate seamlessly with the Mac OS version of 
Dreamweaver, the new visual Web authoring tool announced 
today by Macromedia. 

'this unprecedented level of integration is made possible 
through a close technology paitnership lx*tween the two 
companies. Macromedia and Bart^ Bones Software engineers 
jointly developed the integration technology Ix^hind ' Roundtrip 
HTMtX by taking advantage of capabilities unique to tlie Mae OS 
and BBEdiFs high-tech architeciure, eriiibling the two looLs to 
cleanly exchange HTML ctKlc and preserve the integrity of the 
author’s composition. 

To ensure that all Dreamweaver customers benefit from this 
integration witli OBEdiu Macromedia Is bundling a copy of 
BBFdit with Dreamweaver. In addition, Druarnweaver cusujmers 
can register their copy of BBFdit with Bare Bones Software, and 
thus lx‘comc eligible for Future upgrules and other benefits. 

BBEdit 45 is currently available fnan Developer Depot and 
Bare Hones Software, Inc. 

<http://www.macromedia.com> 

<http://www.devdepotxom> 

CiARis Ships FileMaker Pro 4.0 for 
Windows amt Mac OS 

Claris Corp, announced die immediate availability of 
FileMaker Pro 4.0 for Windows NT, Windows 3d and Mac OS. 
die newest version of its award-winning cross phitform relational 
database software. 

Now with builFin iTHT .server and CGI (Common Gateway 
Interlace) capabilities at an estimated retail price of just $199 
(U.S.), FileMaker Pro 4.0 will collcti and serve dynamic data 
over the Web ft-om computers mih access to die Internet or an 
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inininct via TCP/IP. FileMaker Pro 4.0 is a break* hroygfi intranet 
s<>lutic>n for corporate workgroups and small businesses in need 
of convenient, cost-efficieni access to databases. InfeMaker Pro 
4.0 may also be used to serve data to sophisticated Web sites, 
created by popular web authoring fools. 

Getting a FileMaker Prj 4.0 dambase onto the Web is 
incredibly easy using die prtKluct's new Web Companion plug¬ 
in. With just tile click of a check box, users oan [KTftjnii major 
navigational and editing operations on die Web automatically. 
FileMaker Pro 4.0 provides an easy way to connect Web pages 
to dataliases so that visitors to the site can easily find inloniiation 
tliey require. Secunty fetitures to liinit browser access privilegas 
are also included, and FileMaker Fro Web hosting is available 
through numerous companies. 

Among other advanced features: FileMaker Fro 4,0 inclodes 
a unique drag and drop Fxeel translation tcxil that converts most 
“spreadsheet databases'’ into full-bodied FileMaker Pro 
daLaba.ses in just seconds. U.sefs can .send email from within 
FileMaker Pro 4,0, making it ideal for large mailings 
(LisrServing). Fields may lx.* set to automatically open specified 
lIRhs with just a click. 

Volume pricing Is availabie. and upgrades from laleMaker 
Fro 3*0 and competitive frroducts are available at an estimated 
retail price of S99 (H.H. only ). 

<http://www,filem3kerxom> 

Jovis Database Engine 

OAS Works, maker of List Table, announr ed ihe release and 
shipment of JovLs Version 1.0.4, an XCmd databa.se engine, and 
the only fully stripiahlc datalxtse engine availalile for the 
Macintosh. It allows users to create single-user, and/or 
elient/server applications with any scriptahle application such as 
IlyperC'ard, Suped'ianl, Oracle Media Objects, l^'ontter, and 
others. With Jovis, data is kept in database files external to the 
ap[ilicaiitm. The applicaiitm's .scripts int'lude Jovis "calls' that 
manage and update these files. 

Because Jovis was designed and created as an extension to 
scripting environmen Is (not ’‘spun-ofr from a datalrase 
inunagenient system or any protluct dial requires expert 
knowledge of SQL), it is easy to learn and simple to use. 

Jovis provides over 175 Relational and Architeclyral 
commands. I’he Relational commands provitie all of die standard 
features and performance ref|uireinent,s expected in a relational 
database system. The Architectural commands, (commonly 
referred to as “Flat lale’' commands) include many 
enliancements and capabilities, making them far more useful 
and I'leneficial than f>rdinary file utility tximtmnds. 

With Jovis, deveJopers am .stc^re and retrieve text as blocks 
of data, or as records using relational tables, Additit>nally, they 
can store and retrieve 'Fict's, \snd and iMob's (ISinaty Large 
OBjects). Developers have the ease of use that comes with 
variable field and record lengths as well as coneurreni mulliple 
selections. Most importantly, Jovis gives developers the ability to 
keep their data separate from their application’s interface. 


A Jovis dttafile can contain virtually unlitTiitetl amounLs and 
types of data. Users can store liunclreds of thousands t>f records 
in a single data file, or in mtiltiple open cLila files, limited only 
by hardware sonstrants. 

Jovis Sei’ver uses classic Apple'FaJk an<l System 7.1 or 
greater. It can reach across zones and allow access from any 
kx'ation on a oerwork. No <jther File servers or network 
softw'are is rerjuired. 

The comprehensive printed manual provides everything 
necessary for both learning and using jovis. There are 16 
tutorials, 3 syntax reference seaions, and extensive apjxmdices. 
<http://www.d3swofks.com/> 

PDWF.R'r(M)LS IS Now SHIPPING THE FASTEST 

Mac os Compatible Computer 
FowctT<X)Is announced that they have in stock and are 
.shipping the new X-Fac:tor series Mac 05 cTimpatible computers. 
Based on the greatly antici]xilcd (j 3 (Arthur) prtxressur with a 
“hack-side cache/' these new systems will out perform any 
currently shipping motlels by over 40% in speed. Ihe available 
configurations are as follow.s: 

* X-Factex- 1: 25(}Mliz (G3 Arihitr pnxes.st>r) mini-tower 32MB / 
2.1GB scsk3 hard drive / 24x CD / 5I2k “back side" 12 cache / 
>MB IMS videx) card / KB / RFlkise-T elhemct / Mac OS 8 / 
FWB liard disk tool kit - 

• X-Factor 2: iSOMhz (G3 Adhur pixxessor) mini-tower H()MB / 
9dGH fasowitte hard drive /' fast-wide SCSt-3 card / 24x CD / 
512k “[xick-.side" 12 cache / 4MB IMS vitleo card / Kli / lO 
I5asc-T ethemei / Mac OS H F^B hard disk toi^l kit.- $4,999. 

The 03 seric-s of PowerPC processors from Motorola and 
IBM have lx*en tested to Ix^ the fastest currently available. The 
.speed and perlrirmame of tlie prexessor is also greatly 
enhanced by “back-side cache" technology, wJiidi allows for 
imidi faster ct>inmuniauion rates (Mliz) Ixivveen die prexessor 
and the cache card, When com!lined, the resulting fierformance 
level far exceed.s any currently shipping Mat' OS or Wintel 
computer in the world regardless of the CPU MHz speed. 

Equipped with the fastest possible com|X>nents, rhe X- 
Factor excels in every .single category. I lard disk iransfer mtes 
(sLi.stained) of up to 22MB/Sec can be achieved by the X-Factor 
2. A 24x CD Rom player gives much faster access to applications 
or games from CD-Horn disks. Video support is via an IMS 
1’win']'urlx> I28l)ti vitleo card, often raced as in sfxed and 
pt'fformance. Millions of colors (photo- realist it) can lx achieved 
up lu a 1152 X 870 resolution (21" standard monitor). 

PowerTools first started shipping Mac OS compiiLers in 199C) 
when it received its license. Since then, FowerTix)ls hits 
consistently produced Mac OS c ompatible computers with the 
highe.st performance to price ratio in the Macintosh industry. 
<http:y/www.pwrtoo!s.com> B 
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TIPS & 
TIDBITS 


by Slew Sisak 



Dynamicaej.y Sized Arrays in Think Pascal 

I kre‘s a ti[) r()r Think Pas( at users, whic h has ctxsi me a lot 
of time del:)u^ging every' tunc Tve cTtxssetl it: 

Sometimes you need to create dynamically sii'ud arrays, or 
arrays larger ihan the 32K you can Iniild on the stack, or you 
just want your array in the heap rather than on the stack. The 
traditional way is to turn off range checking, define a type of 
arrayIO..OI of your record, then define a pointer (or even 
handle) to it, and at:ce,ss the array off the pointer or handle, 
ignoring the 10..0] bounds. 1'liis will fail wiih a skidding type 
error if you try to access beyond a 32K size in your array block. 
{By skidding error, iPs one of those that doesn't show up right 
away, hut fails much later down the roach or at unusual places. 
Don't you liate skidding errors!) 

What happens is that with the array[0..0l definitiem, the 
compiler thinks there s only one element (and technically, it's 
right!), and use.s a sixteen bit value to consLrtict the offset. Yes, 
that means the offset will overflow when you hil ihe 32 K limit, 
and you’ll start writing data in the memory space under your 
array, because the overllow will turn the offset negative. The 
way to fix this is to originally declare your array to be a large 
enougli size so that the compiler will know' it has lo use a 32 
bit offset. If you make ii large enough so that you know youll 
never, ever cross it, you can leave range c'heck set on. It won't 
check I he top end of your array, because you’ve made the 
number too large, but it will check the bottom. 

Note also iliat if you detec t ihis, and change the aixay 
bounds in the interface section of a unit, tliat it “will not change’* 
tile implementation in other units. You should force a compleie 
recompile to lx* safe. 

Here's some sample ccxle, using a record with just two 
longs, t>ui with enough records to cross the 32K limit. I Ve given 
constant values Lt> some of the variables, but you can as ea.sily 
use your own dynamic values: 


type 

landki*y = record I tisi* whatever record you want 1 
landsi^eSCHongint: I 1 use two longints \ 

Eeci.U:longiTit: 
end; 

t This code vitl fail If the following array bounds are 
changed tn [0.,0] I 

landkeyArr - array[1..40000001 of landKey; I une a 
ridiculously large number I 
landKeyArrFtr “ ^landkeyArr: 

var 

theSq rth 1 or k: T a [idKuyAc rZt r: 
hi tjckntnrkor. huwmanyKeysiiongint; 

begin 

howteanyKeys hOOD; l Actual array si^e. use what you need 

theSnrTBlnrk ^ lundJteyArrltr(tJewPtrtsi^eof flandKey) * 
hnwtnanyloya)); 

blocktsarJter 5000; \ will write beynnd 3^K > 5000 ' B = 

40DOC I 

theSnrTRlock''[blockaiitkerj .landSizeSF 34343 * 5533; I 
Btuff a value I 
end: 


Oimt Harineil <(mHfnh®h€irk{piin.am> 


Want to share a tip with the 
community and get paid for it? 
Send it in to 

<mailto:tips@mactech.com> 


Send us your tips or we’ll install EvenBetterBiisError on your machine/ On the other hand, we might Just pay you 
$25 for each tip we use, or $50 for Tip of ihe Month. You can take your award in goods, subscriptions or US$. 
Make sure any code compiles, and send tips (and where to mail )>our winningsj lo our Tips e-mail address at 
Hps@tmctech.co,m . (See page 2 for our other addresses.) 
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CLASSIFIEDS 


SERVICES 


The Law Office of Bradley M. Sniderman 

California Lawyer focusing on Intellectyal Property, 
Corporate, Commercial and Contract law, as welt as 
Wills and Trusts. 

If you are looking to protect your software with 
Copyright or Trademark protection, or if you need help 
establishing or maintaining your business, please give 
me a call or an e-maiL Reasonable fees. 

( 310 ) 553-4054 

Brad@Sniderman.com 


Great Products Deserve Great Docs! 


PncujnenUtioji be jin Intcf^l p.irt nf 

your out nn afterlhmjght. Mnniia) 

Liibor In end-it^er 

iLOn (or pnidu^. including 

UaJjwn Hdp {ind Appli? Guide, IITM1. or 
tilt!?*, imd the cver-popular “doiid trw 
edtUon.*' And while we^n? donjmenting 
every luxik and CTonny irf vnur pmditch 
wc can sjmultancnusly provide extmstye 
u.Sidbility flHxltiack, pewJting in (ewpr 
a simpler user Interface, rmiin-ed support 
coshi, and better mviews. 

NflNUIIL LABOR 


CcHiUcI US ttKJjiy to tap iheeJcpcrtifierHjr 
team lies elrvedy brcm);ht to companieK like 
biire Uoiiii^Suftwaitv id Suftwarr. ResrsJova 
Siiftwerv^ Management Quasar 

Knowledge Syf^tems. and S* antn>n Qualdy 
C\lmputer^^. And wr why we'np rhe best 
dHikv (u ilocumeni pEn^r next Mar pnoduct. 

Jerry KindaLI 

SlO/445-^77 

kind a] man ua I a-djti 

h itpj / / w w w.manual-cttm / 

We Wrote the Book! 

Mmmktiiii Tahoku! Gmuttmiifatiflu Faprrt^ 


^ ^ 

^/\N• 

COW' 

Protessfonal software developers 

looking tor career opportunities 
should check out oiu' web site. We 
offer nationwide employment assis- : 
tance, resume help» marketability 
assessment, and never a tee to the 
applicant. 800-231-5920, Fax 800- 
757-9003 eMail:das@scientific.com 

Scientific 
Placement, fiic. 

_ j 




Wanna see your product move? 


\ 



Get it in Developer Depot! 


The fastest, cost effective way to get product off your shelves. 

For information: • Voice: 805/494-9797 ♦ Fax: 805/494-9798 • E-mail: marketing@devdepot.com 
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hy David GtHpbman, RBI Software Systems Inc. and Ingrid Kelly, Apple Computer Inc. 


LaserWriter 8.5.1 Additional CopyBits 
Support:Transparent and Clipped Images 


Overview 

QuickDraw provides severai A Pis fur 
copying bitmaps from one graphics port 
mto another, the must jJexihki (f which is 
CopyBUsO. Most deveiopefs use 
CopyBiisf) because it can move offscreen 
images into an (mscreen window, change 
colors in the pixmap, and resize imagt^. 
This is a useful API, however, 
unfortumUely, f^serWriter 8.4.x and 
earlier PostScript printer drivers from 
Apple have not supported all of the 
capabilities of Ihe CopyBitsO call to draw 
images. Ihis TechNole descrtht^ where 
Apple has enhanced its handlhig of the 
CopyBitsO call in UiserWriter H.5.1 so 
that developers and users may take 
advantage of the improvements. 


In Uiu TtKxJc ptmniieter, imiiy developers Iwve triL^d lo \.\se 
xhc transparent transfer nuKle to achieve rranspareiicy; die 
l^iserWriter driver, however, never suf>|K)neLl this mode hut 
instea<.l treated it as a SR'Copy nuxle. 'lire LiserWriter driver also 
has not SLipported dips in tlie maskR^jn parameter 'fhis lias all 
changetl with the UtserWriter H.5d t^rleasL^ 

Traiispareiit Mode 

One transfer mode previously ynsiipported hy the 
LaserWriter driver rs the transparent transfer mode, ‘riiis nuxle 
allows drawing of images other than l-hit deep so tJiat any 
sample in the source which is tlie iranspareni colc^r (defined as 
ilje Quit kDraw background color) will not [jainied to the 
{JesEinaiioir The advantage of this mode Is that it lets a deep (> 
l‘hit) image have holes in it by coloring ihe holes in the image 
with the transparent color. Whereas previously the l:iserWritdr 
driver wouid paini these images as if the transfer nuxle were 
sreCopy, LaserWriter 8.5. Ts new imaging ccxle now handles the 
transparent mtxie. 


CopyBh'sO 

The prototype for OopyBitsO is: 

void C.<ipyBiiii(const BitHap 'srcBits, 
co5«l BltHap ‘dstflits. const Rect 
isrcRttt. consE Rect MstRect* short 
sigde. RgnHandle msskRgn): 


inaskRgii Clipping 

Another previously imsup[>orted feature of CopyBitsO was 
the ability to pass in a niiisk (via the iniiskRgn field) to dip out 
portions of the deslinatioii image. Previous UiserWriter drivers 
completely ignored the maskRgn passed to CopyBitsO, The 
new imaging code in LaserWriter 8.5.1 tiow sufijKirLs the 
supplied maskKgn. 


I>a\1d tidpiuTtrn seems lo specialize in Ixickwards mattitig t>rogratmiiifig languages, Prom programming in KIRTII ai \lic 
Stanford Linear Accelerator Center, he movtxi into PuslScripi [it Adolx^ Systems and then to lelestiijX at General Magic, tic docs 
do mast otlier things in a mom or less forward direction, aliliougli he has Ixmn kniwri ic» fall off a horse backwards. Diivid, 
together with \m tjoile'ague Kicliiird Blanchard, ca-designe<l Apple’s LiserWriier 8 l^jsiJk ript printer driver wliile wcxking at Adr>l)e 
Systems. After a stint at General Magic, David now works at RBI S<>ftwam Systems thttp://www.rbi,com) ns a t oulractur to Apple 
and Adobe on their PostStTitit printt:r drivers. I le does tither contrsicting work as well, primarily in the area t>f PostScript printing. 

Ingrid Kelly always dreamed of working for Apple Comtiuier while she was growing up in Silicon Valley, Wlmi slie did not 
realize back then wa.s that all of her ex[X!rient:e printing out schtxil papers on an ImageWriter would turn into a iolr supporting 
printing and printer drivers for Apj?le's Developer Technical Support (D'PS) group. After a few years in IJfS, Ingrid has ntiw 
learned to appreciate the hbek magic involved in printing. 
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Nate: While the T-iiserWriter 8.5-1 driver now handles a 
.supplied maskR^n to a CopyBits call, we do not do any speeial 
liandling of the clip provided in the grafPort. GrafPtJrt clipping 
is still handled by clipping only to the bounding rectangle of 
the port's clipRgn^ both for CopyBits calls as well as line ait and 
text drawing. Apple considered more generalized support for 
the port ciipRgn but has rejected it to date mainly due to 
compatibility concerns. 

LlMnAHONS 

There are some known limitations with the added 
CopyBitsO support that you should be aware of. They are; 

* Extremely complex clipping regions may occasionally fail on 
Level 1 or Level 2 devices in low printer memory conditions, 
llie result is that the output will not preserve tlie clip, and the 
image will print as if the maskRgn parameter is ignored. 

Specifically, for PostScript l^vel 1 printers, iliere is a hard 
ctxied limit to how complex a clip can be, regardless of the 
printer's insmiled memory. If the dip is more complex than 
this limit, the LaserWriter driver ignores Lite maskRgn 
parameter. For Level 2 printers, the limits are completely 
memorydyased and generally much more flexible. However, 
once again, in low-memory conditions, the clip may still fail, 
On PostScript I^vel 3 printers, all dips should always prim 
correctly regardless of the complexity of the clip since the 
driver uses the Po.stScripr Level 3 ma.sked image lo support 
this feature. 

* Since the LaserWriter driver implemenns the iranspareni mode 
via clipping, complex transparent regions may occasionally 
fail on r^vel 1 or Level 2 devices in low-memory conditions 
as described alx>ve. The result is that the output does not 
preserve the transparency, and the pixels image with the 
background color instead. 

* Por 2, 4, and 8-bit images with a color Ux>k-up table (CLUD, 
the l^erWriter 8.5d driver only supports one index which 
maps to die background color. Although the CLirf may 
contain many index values which have the background color 
and are therefore, in principle, transparent when displayed 
onscreen, the driver searches the look-up table for the first 
index which corresponds to the Irackgnmnd ajlon Index 
samples with that index value are printed as transparent. 
Other index values which correspond to the background 
color are not treated as transparent but are printed as die 
background color. 


• In order lo maintain compatibiiity with many applic:ations, die 
iaserWriter 8.5.1 driver will ignore a maskRgn which is an 
empty region under some circumstances {e.g. some rotated 
text and grapliics). Some applications have used the faa that 
previous driveis always ignored the maskRgn parameter to 
clip out certain data when prindng to QuickDraw printers. 
Relying on this Teaturc' is not recommended, and the fact that 
diere are some edge cases where a zero clip is ignored for 
compatibility reason.s may be a temporary 'feature^ of the 
driver. To avoid accidentally encountering these cases, when 
you really want a zero clip, either do not draw die image 
(preferred) or use grafPori clipping to clip it. 

Summary 

New imaging code in the LaserWriter lias opened up some 
new functionality for die QuickDraw CopyBitsO call. We 
enetjurage you to try LaserWriter 8.5.1 with your application and 
any PostScript device. 

Further References 

• Inside Macintosh: Imaging With QuickDraw, Chapter 3 and 
Appendix R, 

• Apple's TcchNote web site 
<http://tievwofld.apple.com/dev/technotes.shtml> 

• PostScript Level 3 dtK:umcntation from Adol^e Systen^s 
Incorporated. 
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by Richard Blanchard, RBI Software Systems Inc., Ingrid Kelly, Apple Computer Inc. 
and Chomg-Shyan Lin, RBI Software Systems Inc. 


LaserWriter 8.5.1: 

The Extended ‘PAPA’ Resource 


Overview 

Slarlinf* unih LaserWriler 8.5^1 1 in 
order to support different types of desktop 
printers, the TM^A' -^192 resource bos 
fjeen extended from 103 to 1024 bytes tong. 
This TecbNote discusses the additional 
bytes and in what way the LaserWriter 
S. 5. / driver uses them. 

Note: If your code reties on the size of 
the 'PAPA' resource, it may crash wUb 
ImerWriter 8.5A unless you update it to 
sup}xirl the extended PAPA * resource. 


is a series of tagged blocks where each block contains a 4- 
byte tag, followed by a 2-byte length value, and then the 
actual data. A scries of llicsc tagged blocks can reside in bytes 
104 to 1024. 


Tag Requirements 

There are a few requirements for the tagged blocks that go 
into the extended PAPA/ I’hey are^ 

* The only required block in an extended TAPA' is the TAGS' 
tag which gives the number of valid tag blocks in the 
extended resource, ITie TAGS' block must be the first tag tn 
the extended record and serves as a validity check. 


The ‘PAPA’ Resoiirct^ 

The new TAPA' looks just like an 
old style *PAPA' at the front of the 
resource; that is, the ‘PAPA' resource 
begins with three packed Pascal strings 
representing the printer name, the 
network type (usually I^serWriter), and 
the printer's zone. After these strings 
comes the 4-byte netw'ork address. 

The new extended ‘PAPA' then adds 
desktop printer (DTP) data beginning at 
the 104th byte in the resource. The data 
from bytes 104 to 1024 (1-based indices) 


• When the extended portion of the TAPA' contains 
multiple tag blocks, each block is required to start on a 
word Cl6-bit) boundary. Thus, if a tag block has an odd 
length, there should be a byte of padding before the stan 
of the next tag block. 

• tn order to limit the number of clients that need to 
understand the extended TAPA' format, and to make it 
easier to change the format in the future, the SetiingsLib 
provides routines for creating and accessing the extended 
‘PAPA.* Relying (jn the extended ‘PAPA* formal rather than 
using SetlingsLib is a bad idea. For more information on 
SettingsLib, please see Apple’s I'eehNote web site. 


Rk'li^iid SSbndnird has been programming LaserWriter 8 since its inception and one day hopes to finish it. Working at 
RBI Software Systems, Inc. Richard, from day to day, codes in C, C++, and Java and tries to draw a bead on the future 
of network printing. 


works in Apple's Developer Teclinical Support group. She was sad to sec die Blue Angels air show^ season end 
this year, but never fear, she is already counting dowm the days until the start of next year's air show season. 99 -PR -97... 


im is a Macintosh developer at RBI Software Systems, Inc. He can be readied via email at <lin@rtx.com>. 
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Tau Types 

Tag: ‘TAGS’ 

Value Size: ,sim>R tIlntl6)^ 2 bytes 

The value of the TAGS’ l>lock provides the nuinlx^r of valid 
tag lilocks in the extended print record including itself, Ihe 
TAGS' block must lie the first tag in the extended print record; a 
valid extended priril record iiiusl Lliererare l>egin with the byte 
sequence: 0x5441 0x4753 0x0002. 

Tag: ‘TYPE’ 

Value Size: sizeoROS'rype), 4 bytes 

'Ibis tag is optitinril as its contenrs are redunriant given the 
PAPA zone name string. If this tag does exisLs, then its value iiiusl 
niiitch, not literally but in meaning, the L>T1^ type implied by the 
zone string. Here are the zone string mappings to ^ ITPE’ values: 


Zone Name 

SIriitg 

■TVIk-’ 

tag value 

IXTiaitbn 

=Flld 

■I four 

('realLS ami ivolds spx)! Hies, T'he 
,sp(K)l files are never prtxxmxl and the 
n iP is mil ronneetetl iu a real printer. 

=Fir 

■=Fil' 

C,featt:s Pt»st.Seri|H or l‘PS files, is 
ntH omneeled to a real priniei. 

=Cst* 

“Csf 

Craues a PastScripl file and then 
laiindit^ an appliailion lu 
the file. 


HJ*R' 

Semis a I*MJ>cfi|X job using the U*R 
pniUKol. 

=lrd' 

•"iitr 

Semis a PostS<Tt|X jo!> over an inb, 
infrared, diannel. 

Valid 2tjnc firing 

•l’AI> ■ 

Uses ihe AppleTalk I'Al* pn)l<x‘ul u> 
print the jd). 


In the prtxetling mapping, the in die zone name string is 
a wildcard which c an be replaced by zero or metre chanu'ters of 
any value. The 1>TI^ Utility uses this |)an of die zone name string 
to differentiate l>etween printers of the same type with the 
same name Icxated in different folders. 

Beside the Lag values *Hold\ -Fil', ^=Cst\ '=LPR“, -Ird*, 
and ’PAl^ uiher tag values may be added in tlie future for 
new DTP types. 


Tag: TCP ’ 

Value Size: variable size string 

if the iy\V printer type requires a TCF/IF network address, 
it is plated in the extended PAPA using the ‘TCP ’ tag. The value 
of the lag blex’k is the network address t>f the printer eidicr as a 
fully qualified network address, such as colorlaser.apple.com, or 
in dot formaf .such as 204.188.109-151, 

This tag is required for DTP printers of type -LPR/ 

The length of the .string is determined from the block length. 

Tag:‘Q ’ 

Value Size: variable size string. 

If a D'fP on use a print queue name, as can IJ^K DTPs, 
then the print tjycue name is placed in a tag value block of 
type Q : 

The length of the siring is determined from the block length. 
Summary oe DTP type, zone names, iVND tags. 


DTP Type 

PAPA Zone ^String 

Extended Data Tags 

PAP 

Actual Zone Name 

TVTF; is TAP ‘ 

Hold 

- 

is 'Hold’ 

Save IU File 

=rip 

TfPV.' is ^=Fif 

(-usttari 

=Cst* 

1TPK’ is ’-CsP 

im 

=LPK‘ 

TYi’E' is ’-LPR' 

TCP ' is primer's ml address 
’Q ' i.s fj|Tiional and Ls the 
name of the print spooler. 

InfraKed 

=lrd 

■nPE‘ ts '=trd' 


Summary 

This 'lechNote has dcxiimenleti the changes in die TAPA’ 
re-source in laserWriter 8,5,1. Pieitse Ix^ware if your application 
dejK'nds on the size of the ‘PAPA’ as ii may no longer work with 
LiserWriter 8,5,1, 

Further Reference 
* Apple’s ’lechNote web site at 

<hnp://devworld.applacom/dev/techncitEs.shTml>. 
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by Apple Developer Support Center 


Macintosh Q & A 


White Backgrounds for Dialog 
FD ifl'FXT Items 

Q, 1 would like to have a colored 
background for my dialog box but 1 
would like the TexlEdiL fields in my 
dialog box to be white. Is this 
possible to do? Is there some sample 
code available? 

A. Generally speaking, this coloring is 
achieved via resources, not code. In 
addition to tlic detb' resource, you 
need to create an ietb' resource. 

To download a ,sample of an application 
using this kind of lesource go to 
<http://devworid.apple.confVdev/qa/t^ 

The ’ietb' resource is documented on 
page 6-76 and staning again on page 6- 
15B of Inside Macintosh: Macintosh 
Toolbox Essentials. Tlie best way I 
know of to create and edit Ictb' 
resources is with Resorcerer, hut you 
can also create them with a '.r' file 
compiled by either MPW's Rez or the 
Meirowerks Q)deWarrior equivalent. 

Here are some references to web sites 
for the aforementioned tools: 

Resorcerer: 

<http://www.mathemae5thetics.com/> 

ETO (inch Rez); 

<hltp://www.devtools.applexom/eto/> 

Code Warrior: 

<http://www.metfowGfk5.com/> 


If this response has failed to adequately address a question or 
has raised more fjuestions than it answered, pleaxe feel free 
to let us know and well try again. 


Pete Gontwr 

OTScheduleDeferredTask When Task Runninc; 

Q. What happens when you u.se OTScheduleDeferredTask to 
schedule a task that is aiiming? 

A. The “Open Transport Client Ncjte” mentions that 
OTScheduleDeferredTask returns false when you attcnijH in 
schedule a task that is already scheduled, but it doesn’t say 
anything ab<.nit what happens if the task is running. It turns 
out lliat a task tliat is running is nt>l consider to be schcdtilcd, 
so OTScheduleDeferredTask will successfully reschedule it. 

Quinn Eskirnor 

Gestalt Vahje.s for REtaysT MACim'OSH Models 
Q* What are the 'mach' gestalt values for the recent 
Macintosh models? 

A* Recently, we announced the following new Macintosh models: 

PowerBook 2400 

The following list includes the inach' gestalt selectors for 
these and other Macintosh systems which are not included iii 
the Gestalt.h header file which is part of the “Universal 
Interfaces 2.1 in Ml’W Latest** on ETO ^^22. 

• gestalrPerforma5300 = 41; ( Macintosh Performa 53xx 1 

• gestaitPowcrMac5260 = 41; 1 Power Macintosh 5260/100 i 

• gestaitPerforma6300 = 42; | Macintosh Performa 63xx, 
except 6360 1 

• gestaltPerforrna6360 = 5B; 1 Perfonna 636 O ] 

• gesialtPerforma64Q0 = 58; i Performa 6400 1 

• gesta]tPowerMac9600 = 67; I Power Macintosh 9600 
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Find Desktop F(>ij>pr 


gestaltPowerMac7600 == 68; \ Power MacintOfili 7600 } 
gesraltPowerMac8600 = 69; I Power Maemtosh 8600 1 
gcsLalLP(wcrMuc5400 = 74; 1 Power Macinrosh 5400/120) 
gestaItiMacLC580 ^ 99; i Macintosh LC 580 } 
gestaitPerforma5S0 = 99; I Macintosh Peiforma 580 1 
gcsLakP<)werMacLC475 = 104; I Mac LC 475 & PPC Processor 
Upgiade Card 1 

gestaitPowerMacPerforma47x = 104; { Perfomia 47x & PPC 
Proc Upgrade Card I 

gestaltPowerMacLC575 = 105; I Mac LC 575 & PPC Frcx:fc\ssor 
Upgrade Card I 

gesLaiiP<)werMacPerforma57x ^ 105; I Performa 57x & FPC 
Proc Upgrade Card ) 

gestaltFowerMacQuadra630 = 106; I Quadra 630 & FPC 
Pojcessor Upgrade Card 1 

gestaltPowerMacLC630 - 106; | Mat: LC 630 & PPC Processor 
Upgrade Card 1 

gestalt?owerMac7300 = 109; I Power Macintosh 7300 1 
gcstaltlhjwcrMacQuadni700 = 116; ( Quadra 700 Sn Power PC 
Upgrade Card 1 

gestaltPowefMacOuadraOOO ^ 117;) Quadra 900 8c Power PC 
Upgrade Card 1 

gestaltPowerMacQuadra950 = 118; | Quadra 950 & Ptwer PC 
Upgrade Card 1 

gestaltPowerMacCentris6l0 = 119; 1 Centris 6l0 & Power PC 
Upgrade Card 1 

gestaltPowerMacCentris650 = 120; 1 Centris 650 & Power PC 
Upgrade Card 1 

gesiaJtPowerMacQuadra6l 0 = 121; ( Quadra 610 Sc Power PC 
Upgrade Card ) 

gestalrPowerMacQuadra650 = 122; { Quadra 650 Sc Power PC 
Upgrade Card 1 

gestaltPowerMacQuadraHOO = 123; I Quadra 800 Sc Power PC 
Upgrade Card | 

gesiakPowerLSook3400 = 306; 1 Macintosh PowerBook 3400 I 
gestaltPowerliook2400 = 307; ( Macintosh PowerBook 

2400 ) 

gestakPowerBo(jkl400 ^ 310; ( Macintosh PowerBook 1400 ) 
gestaitPowerMac5500 = 512; | Power Macintosh 5500 1 
ge5talt20thAnnivMac ^ 512; ( Twentictli Anniversary 
Mac:intosh I 

gestaltFowCTMac5500 = 512; ( Power Macintosh 5500 I 
gestakPowerMac65(X) = 313; ( PowerMacintosh 6500 I 
gestakP(wiTMac4400 = 515; I Power Macintosh 4400 t 

Note: To distinguisli the Twentieth Anniversary Macintosh 
from the Power Macintosh 5500, make a secoridary Gestalt 
.selector call to the selector Bxid'. 'Ihe response for a 
Twemietli Anniversary Macintosh will be Ox0000302R 

Rich Kubota 


Q, The General control panel (GCP) in 7.6, 7.6.1 and 8.0 has the 
document options: Last folder, Application set folder, and 
Documents folder. How can my application determine where 
this folder is? 

A. The General control panel (GCP) patches FindFolder so it will 
return the correct document folder given the current GCP 
options. Pass RndFolder a folderType of 'docs\ One quick 
note: Because the GCP patches FindFolder, the createFolder 
option doesn’t work. If the folder doesnl exist you won’t gel 
an error and it won't be created. You have to write code to 
determine if the folder actually exist: il' it doesn't, youll have 
to create it yourself. 

George Warner 

MemErhor 

Q, When 1 am debugging my application MemErrorO always 
returns noErr. What’s wrong with MemError()? 

A, Nothing, if you are debugging your application with a high 
level debugger. High level debuggers often call Memory 
Manager routines while stepping through your code. When 
a Memory Manager routine is called, it sets MemError() and 
in this case, the debugger's memory request was successful 
(it returned noErr) and cleared your application's 
MemErrorO result. 

The solution to this problem is often just to not step over 
Mem{)ry Manager calls and the call to MennError(), If you put 
a break point just after the MemErfor() call, you usually get die 
correa error — the one your application would see if it 
wasn’t running in the debugger. 

ILie other option is to use a low level debugger such as 
MacsBug to debug your memory allocation problems. 

As a general rule your application should check the value of 
the handle or pointer returned by NewHandle, NewPtr, etc: 
and if it is nil, you should call MemError() for an error numben 
Just calling MemErrorO without checking the value of the 
handle/pointer is not a good idea. 

Mark Cookson 
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iiscr siithfef tkm, lower prices and against defects. If, for any ix^ason, you are 
iKJl satisTit^i ur find die .iaitie protiucr a( a lower price within 30 days, please 
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metrowerks 


CodeWarrior for 
PalmPilot 

by Metrowerks 

CodeWarrior for PalmPiiot is 
the first complete set of tools 
which enables you to develop 
for the U.S. Robotics PalmPilot 
connected organizer, from the 
comfort of your PC or 
Macintosh computer. All the tools you need are included; the 
award-winning CodeWarrior IDE, compiler, linker, source-level 
debugger, GUI builder, and other tools, plus online 
documentation and reference materials. Includes one free 
product update and free technical support with registration, 
(SCWPALM) Our Price $369 


Check out our Web site! 

^ • Full piuduct descriptions • Hundreds of more products 

http://www.ilevdepot.coiii 





CodeWarrior 
Latitude 

by Metrowerks 

Don't throw away the 
Investment you have made 
In your Mac OS application! 

With the new DR2 release 
of CodeWarrior Latitude, you 
can now port your Mac OS 
application to Rhapsody, as 
well as Silicon Graphics IRIX 
and Sun Solaris. At the 
heart of Latitude is a set of shared libraries which performs the 
functions of the Macintosh API. You recompile your Mac OS source 
code, linking it with the Latitude libraries to produce a native 
application. As the Rhapsody API evolves, so will Latitude. 
Registered users of CodeWarrior Latitude will receive alt developer 
releases, the first full release, plus one additional product update, 
to ensure that you have access to the most up-to-date Rhapsody 
porting tools available. 

(SCWLAT) Our Price $399 



by Metrowerks 


• Start programming for the new, innovative Be Operating 
System (BeOS) with complete set of Codewamor tools 

• BeOS-native Integrated Development Environment (IDE) with all 
the familiar CodeWarrior features at your fingertips 

• A BeOS PowerPC compiler and linker, an editor w/syntax color 
and styling, and a source-level debugger 

• BeOS header and libraries, complete documenration. useful 
C-i-f classes, and sample code 

• Now includes Java support 

• The BeOS Preview Release allows you to run and program for 
the BeOS on a 603 or 604 PCI based PowerMac 

(SCWFB) Our Price $299 


MW Visual 
SourceSafe 
Release 5 

by Metrowerks 

• Source code control 
system, plug-in to the 
CodeWarrior IDE or 
stand-alone Client application 

• Compatible with Microsoft Visual SourceSafe version 5.0 

• Cross-platform support (Mac, Windows, UNIX) 

• Configuration management in excess of 4 billion files 

• Over 8,000 files and sub-projects in a single sub-project 

• Registered users receive one year of tree technical support 
and one free update 



(SMWVSS) Our Price $499 
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CodeWarrior 
Discover 
Programming 
Edition 

by Metrowerks 

• Learn to program in C/C++/Java/Pascal 

• Full-featured programming product-not a "lite” edition 

• Online books and tutorials 

• Hosted on eitfier Mac OS or Windows 95/NT 
CodeWarrior Discover Programming Edition offers an unbeatable 
combination of full-featured programming tools, online books 
and instructional materials, all at a great price. Whether you 
want to learn the basics of programming or add a new language 
to your skill set, Discover Programming puts the information and 
tools you need at your fingertips; the award-winning, easy-to- 
use CodeWarrior Integrated Development Environment (IDE), 
four of the most popular programming languages, online books, 
online tutorials, sample source code and hee technical support 
(with your registration). Discover what you can learn with 
CodeWarrior. buy your copy today! 

(SDPED) Our Price $79 



Order Toll-free 
800-MACDEV-1 

■U00622-33«l| 


^ Apple Dylan 

Apple Dylan Technology Release 

by Apple Computer, Inc. 

• Contains a PowerPC-native prototype version of a development 
environment based on the Object Oriented Dynamic Language 
(OOOL) Dylan. Developers will be able to produce code targeting 
both 680x0 and Power Macintosh systems 

• Automatic memory management 

• Application framework and user-interface & builder 

• High-level exception handling 

• Cross-language support tor C code and APIs 
CD & Online Documentation 

(SAOTRO) Our Price $ 39.95 
CD & Hardcopy 

(SADTRH) Our Price $ 59.95 


CodeWarrior 
Professional Release 2 

by Metrowerks 

• Includes Windows 95/NT and Mac OS versions of the 
CodeWarrior IDE 

• Supports C. C-r-r, Java and Pascal 

• Develop for Windows 95/NT on x86 and Mac OS on 
68K/PowerPC 

• V2 Project Manager supports multiple open projects, subprojecis, 
multiple targets per project, and threaded execution 

• Support for JDK 1.1.3 in CodeWarrior Java 

More platforms, more languages, more options: CodeWarrior 
Professional Is designed to give you the tools you need for 
serious, industrial-strength programming. CodeWarrior 
Professional is the only Integrated Development Environment 
(IDE) in which you can edit, compile and debug C. C-t-t-. Java 
and Pascal programs for multiple target processors and 
operating systems. CodeWarrior's compilers produce fast, highly 
optimized code for Windows 95/NT running on x86, or Mac OS 
running on 68K or PowerPC processors. CodeWarrior 
Professional features the CodeWarrior IDE Version 2. The 
revamped Project Manager supports multiple projects open 
simultaneously, multiple targets per project, and threaded 
execution, and it’s significantly faster. CodeWarrior Professional 
also includes online books, documentation, and reference 
matehals, as well as tutorials and sample code. We support 
your development efforts wi^ one free update and free world- 
class technical support for a year with registration. 

ISCWPR02) Our Ffkx $449 
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MkLinux: Microkernel 
Linux 

for the Power Macintosh 

by Prime Time Freeware 
MkLinux is a native port ot Mach 3 and 
the Linux 2.0 kernel, complemented by hundreds of commands 
from BSD, GNU. and X11. It runs on most (NuBus and PC! bus) 
Power Macintosh systems: Performa. PowerBook. and 
multiprocessor ports are currently under development. 

MkLinux is robust, powerful, freely distributable, and source code 
compatible with most other Linux systems. It provides a full suite 
of development toots, support for AppleTalk, NFS, and Objective- 
C, and access to a vast amount of tree software. MkLinux is a 
great way to “come up to speed" on Mach, UNIX, and Rhapsody. 

• MkLinux user community supports FTP and web servers, 
development and porting efforts, and several mailing lists 

• The Apple sponsored reference release contains a wealth of 
introductory and reference material on Linux, Mach. NeXT, and 
the Power Macintosh 

• Includes free 3.0 upgrade 
{BMKUNUX) Our Price $50 


Mk Linu X 



Check out our Web site! 

Full product descriptions • Hundreds of more products 

http;//www.clev(lepot.com 


Pro Fortran 

by Absoft Corporation 

Absoft Pro Fortrai combines native F90, VAX compatible F77. and 
C/C++ compilers into a single, easy to use environment. All compilers 
are link compatible and operate through a common interface. 

• Graphical debugger, browsers, array display, performance profiler, 
linker, MRWE application mainframe 

• MIG graphics library, Absoft Create Make, several utilities, the 
latest version of MPW and illustrated documentation 

• Whole array operations, modules, interface blocks, and user- 
defined types or data structures 

• Dynamic memory ateation and new control constructs 

• F90 is link compatible with Absoft F77. C++. MrC and 
CodeWarrior 

• It is tully compatible with Toolbox. MPW tools, and most third- 
party products 

(SAPROF) Our Price $899 

Order TelMree 
800-IIUCDEV4 

(m62?-33SI| 


VIP-BASIC: 

Visual Interactive 
Programming in BASIC 

by Mainstay 

Now you can aeate full-featured, stand-alone 

Macintosh and Power Macintosh applications in standard BASIC code! 

WP-BASIC 2.0 is the fastest way to program your Macintosh. 

• Rapid application development environment with application 
framework, mix and match: ViP-BASIG high-level subprograms 

• Import pre-existing BASIC code: automatically integrate BASIC 
code, export C Code for compiling: automatically convert your 
BASIC code to C for compilation with Metrowerks' CodeWarrior 
(SVIPBASIC) 0urPrice$195 




Macintosli Common Lisp 4.0 

by Digitool, Inc. 


Macintosh Common Lisp provides users 
with a rich set of object-oriented dynamic 
language features making it especially 
well-suited for rapid prototyping, custom 
development for business and education, 
scientific and engineering applications, and academic research. 


• Power PC native environment & compiler, full Macintosh support 


VIP-C: 

Visual Interactive 
Programming in C 

by Mainstay 

Now you can create full-featured, stand¬ 
alone Macintosh and Power Macintosh applications in just minutes. 
VIP-C 2.0 is the first rapid application development system for 
creating complete Macintosh programs in standard ANSI C. 

• Includes powerful, tightly integrated visual debugger. Import pre¬ 
existing C code: automatically Integrate C code with a current project 

• Includes full-featured mini database; (ltd to 32K] otthe powerful 
VIP-BASIC database manager gives you everything you need to 
setup royalty-tree, multi-user database applications 

(SVIPC) Our Price $295 


• CLOS, the stfflidard Common Lisp object system 

• Interactive dynamic environment, multiple processes 

• Automatic memory management and seif-typing data 

• Ephemeral garbage collector, smaller application footprint 

• Compiles with Common Lisp industry standard and smart 
programmable tools, 110+ mb of user contributed code 

• Complete on-line documentation (manual sold separately) 

• Software license and registration card 
(SMCLISP) Our Price $675 
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ObjectMaster 
Professional Edition 

by Altura Software, Inc. 

Object Master is an innovative programming environment that 
provides ail the necessary tools to write, organize, and navigate 
through source code. 

• Write code using the most robust source code editor available 
on the desktop 

• Organize source code into projects to quickly access and 
manipulate all files 

• Navigate through source code using intuitive graphical 
Browser windows 

(SOMPE) Our Price $399 


Roaster 

by Roaster Technologies, Inc. 

Get the most out of Sun’s Java™ 

programming language with this 

powerful development environment, 

• Features include; ability to build 
stand-alone Macintosh applications 
or applets; visual interface builder; 
ability to create cross-platform zip 
files; powerful Java debugger; wizard for quickly creating Java 
applets or applications; JDBC included; Java object database 
included; ability to call AppleScripts from Java; Just-in-time (JIT) 
compiler; JDK 1.0.2 support (JDK 1.1 support with a free web-based 
update); class tree and hierarchical class browser; much more! 

• Software includes; Over 300 example applets and applications; 
Netscape Internet Foundation Classes; Object Design's PSE for 
Java; OpenLink Software’s JDBC Drivers; OpenSpace Java Generic 
Library; Microline Component Toolkit Lite 3,0; much more! 

• Requirements: Runs on 68k or PowerPC, CD-ROM 

■ Price includes all web-based updates. Release 3 owners now have 
access a web-based update to Release 3.1 with JDK 1.1 support. 
(SR0AST3) Our Price $99 



NS BASIC 3.6 
for the Newton with 
Visual Designer 

by NS BASIC Corporation 

• A fully interactive implementation 
of BASIC programming language 

• Runs entirely on the Newton - no 
host is required 

• Create files, access the built In 
input and output 

• Work directly on the Newton, or through a connected Mac/PC 
and keyboard 

• Get me BASIC Internet Tool, available at no charge to NS BASIC users 
from www.nsbasic.com 

• Release Notes with sampie code are available from the same location 

• Runs on any Newton MessagePad 130 with NS BASIC and the 
Newton internet Enabler. Also runs on MP1201s with NOS 2.0 that 
have full memory available 

• Write short programs to access News, mail and the web 
(SNSBASIC) Our Price $99 



soups, and the serial port tor 



'^TENON 

INTERSYSTEMS 


CodeBuilder 

by Tenon Intersystems 


CodeBuilder is a powerful and unique Macintosh software 
development too! for porting existing apps or developing new, 
advanced applications on Power Macs and Power Mac clones. 

• A powerf ul Macintosh software development tool suite of C, C+-I-, 
Objective-C, Java, Ada, and Fortran development tools 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

■ Includes compilers and source-code debugger for Objective C, and 
C, C-i-(-, Ada 95 and Fortran 77 

• Web & internet scripting tools: Perl, MacPerl, tcl/tk, bash, sh, and csh 

• Supports Rhapsody kernel APIs and Rhapsody TCP sockets 
(SMIOCODEB) OurPrice$149 


t WAIT-'* - 

The'*.*, Here’s a list of all available products. For full product descriptions 
MoreU please see our Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

LPA MacProlog Developers Edition 

SLPAD 

995.00 

LPA MacProlog Programmers Edition 

SLPAP 

495.00 

LS Fortran Pro 

SLSFORT 

595.00 

LS Fortran Plug-In 

SLSFPI 

199.00 

Mac FORTRAN 11 

SF0RT2 

595.00 

Power MachTen-UNIX 

SM10PPC 

695.00 

Presenting Magic Cap 

BPRESMAGIC 

15.25 

SmalltalkAgents 

SSTA 

695.00 

Think Pascal 4.0 

SPASCAL 

165.00 



Web site: http://www.devdepot.com • E-mail; orders@devdepot.com 
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PoweiKey Pro Model 200 

by Sophisticated Circuits 

PowerKey Pro Model 200 iets you start 
up and shut down your Mac and up to 
five peripherais with a 
single keystroke. Two 
groups of switched 
outiets let you control 
some peripherals 
separately. PowerKey 
also features phone 
ring startup which 
lets you access your 
Mac while on 
the road. 

Powerful scheduling 
features let you 
control your outlets with “hot keys" or 
perform tasks unattended. Start up your 
computer at any time of ^e day or night, 
open applications and run AppleScripts 
or QuicKeys. Add the optional Server 
Pestart Option and you can even restart 
crashed servers automatically! 

System Requirements; Mac with ADB 
port, System 7 or later. Telephone 
features require analog phone line. 
(HPKEY2) Our Price $99.95 


PowerKey Pro Model 600 

by Sophisticated Circuits 

PowerKey Pro Model 600 is "the world’s 
smartest power strip!" Start up and shut 
down your Mac and 
peripherals with a single 
keystroke. Includes six 
individually-switched 
outlets, with manual 
switches and indicator 
lights. Powerful 
scheduling features let 
you control outlets with 
“hot keys" or perform 
tasks unattended. Start 
up your computer at any 
time of the day or night, 
open applications and run A|:q}leScrTpts or 
QuicKeys. Complete telephone controllability 
lets you start up the computer, switch outlets 
or run complex events using custom touch- 
tone commands. For a iimited time. Model 
600 includes the Server Restart Option. 
Restart crashed sen/ers automatically! 

System Requirements: Mac with ADB port, 
System 7 or later. Telephone features 
require analog phone line. 

(HPKEY6) Our Price $199.95 



ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C+-r classes for integrating Internt 
e-mail in your applications 

• Helps you write software that can share mai 
with other leading e-mail products 

• Royalty-free MIME, SMTP, and POPS APIs fu 
Macintosh. Windows, and Unix 

• Gives you the most robust MIME parser and 
encoder available 

• Ideal tor use in Internet and Intranet 
environments 

• Comes complete with samples with 
documented, reusable source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 



ScriptDemon 

by Royal Software, Inc. 

ScriptDemon is a browser plug-in that, 
for the first time, allows you to deliver 
and mn AppleScripts from Web pages. 
The ScriptDemon plug-in will execute the 
embedded AppleScript code included on 
a Web page. ScriptDemon painlessly and 
inexpensively handles many previously 
impossible tasks, such as; 

• Using the Intranet to manage all 
Macintosh computers on-line 

• Using the Internet to install and 
configure software 

• Using the Internet to configure 
hardware 

• Delivering complex sets of files and 
assembling them on the browsing 
computer 

• Providing interactive education and 
product support on both the internet 
and Intranet 

• A perfect companion to LiveCard! 
(SSDEMON) Our Price $949 



Memory Mine 

by Adianta Inc. 

• Monitor heaps, identify problems such as 
memory teaks, and stress test applications 

• Active status of memory in a heap is 
sampled on the tly; allocation in non- 
relocatable (Ptr), relocatable (Handle) and 
free space is shown, as are heap corruption, 
fragmentation, and more 

• Allocate. Purge. Compact, and Zap memory 
lets users stress test all or part of a program 
(SMEMMINE) Our Price $99 


Future Basic ii 

by Staz Software 

FutureBASIC II is the award winning leader in Macintosh BASIC 
programming. 

• Source level debugger and interactive compiler/editor 

• Multi-file Project manager and Multi-file find and replace 

• Super fast compilation, 32 bit clean, and System 7.x savvy 

• QuickBASIC converter 

• Getting Started manual with over 500 example tiles 

• Full support of standard BASIC 
(SFBASIC2) Our Price $229 
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Visual MacStandardBasic 3.0 

by ZCurve Software 

Visual MacStandardBasic is the new standard for creating both 

68K and Power Macintosh applications, 

• Applications can be visually created in minutes 

• Visual controls such as command buttons, text boxes, list 
boxes, radio buttons, check boxes, scrollbars, icons, pictures 
and timers can be created and modified Instantly 

• Use color graphics, animations, movies, sounds and speech 
in your programs 

• Console text window option helps converting older BASIC 
source code from other platforms 

• Online tutorial, manuals, sample projects get you programming quiddy 
(SVMACSB) Our Price $99 


5P0TLIQnT 


SpotligM 

by Onyx Technology, Inc. 

Spotlight Is a stand alone 
debugging aid that performs memory 
protection (arrays, heap accesses, outside 
your heap, low mem, etc}, discipline checking 
on toolbox calls, and leaks detechon. 

• Spotlight is sold on an annual subscription 
basis 

• Tlie subscription service provides all updates 

• Includes maintenance releases for one 
year after 

the initial purchase or renewal dale. 
(SSPTLT) Our Price $199 


QC 

by Onyx Technology, Inc. 

High performance runtime stress testing for applications, 

• Tests include heap checks, purges, scrambles, 
handle/pointer validation, dispose/release checks, write to 
zero, de-reference zero as well as other tests like free 
memory invalidation and block bounds checking 

• Extremely user friendly - ideal for non-programmer testers 

• Also available in Japanese 
(SQC) Our Price $99 




' MacA&D 


MacA&D 6.0 

by Excel Software 

• Structured analysis 
and design 

• Object-oriented 
analysis and design 

• Real-time and multi¬ 
task design 


• Data and screen modeling 

• Integrated code editing and browsing 

• Multi-user dictionary and requirements 

• Code to design diagrams for C, C-n-.etc, 

• Design diagrams to code for C, C-i-i-, etc, 

• State modeling diagrams and tables 

• Use cases with traceability 
(SMACADP) Our Price $1995 



Apprentice 6 

by Celestin Company 

Apprentice 6 is a high-quality CD-ROM 
collection of over 600 megabytes of up-to- 
date source code, utilities, and info for Mac 
programmers. All of the source code and 
utilities are completely new or updated for 
this release. 

• Frontier 4.1, tfie highly-acclaimed 
scripting environment 

• More PowerPlant AND many more 
PowerPC samples 

• Coot new languages and environments 
added (Clean, Eiffel, F, Tcl-Tk) 

• Hot new demos from leading Mac 
development companies 
(SAPPREhTTe) Our Price $35 


StoneTable 68K/PPC 

by StoneTablet Publishing 

StoneTable is a powerful and professional 
replacement for the List 
Manager used by developers worldwide. 
Version 3.0 is a new release with many 
improvements including better clipboard and 
drag/drop integration with other applications. 

• Available for use with CodeWarrior C & 
Pascal 

• Includes libraries for 68K (A4 & A5) and 
PowerPC 

• An LTable-like class is provided to 
incorporate StoneTable Into the 
PowerPlant environment 
(SSTONEFAT) Our Price $199 



VOODOO 1.8 

by UNI SOFTWARE PLUS 

• Stand-alone version control tool for all 
sorts of projects (software 
development, documentation, design, 
CAD, publishing, etc.) 

• Smooth integration with Metrowerks 
CodeWarrior and BBEdit. 

• Simple and clear management of variants 
and revisions of entire projects (not only 
of single files) 

• Easy-to-use graphical project browser gives 
access to all versions that were ever stored. 


• Recording of the complete history (who 
made which changes when and why) 

• View differences between versions [not 
only for text files!) 

• Efficient delta storage of arbitrary files 
(text as well as non-text 

files) gains savings of 95 % and more 

• Administration of users with hierarchical 
access rights 

• Configurable local file locking (Finder flag 
or ‘ckid’ resource) 

• Scriptable, essential parts PowerPC native 
Single license (SV00D001) $229 

2 pack {SV0OD002) $359 
5 pack {SV00D005) $799 
10pack(SVOOD0010) $1369 
20 pack (SVOODOO20) $2399 
Additional pricing available on request. 

SEE RELATED CATEGORY; Dev, Environments 


Web site: http://www.clevdepot.com • E-mail: orders@devdepot.com 
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Be Basics 

by BeatWare 

Be Basics is the first productivity suite to 
combine the essential tools you use 
everyday with the incredible power of the 
BeOS. Be Basics 

offers the BeOS developer the ability to: 

• Combine text, tables, graphs and pictures to create compelling 
documents 

• Work with multiple files simultaneously without degrading performance 

• View all layout, style and content changes as they happen 

• Import Microsoft Excel files 

• Plug-in third party graphs and filters 

Be Basics requires the BeOS, 16 MB of RAM, 2 MB available hard 
disk space and a 256-color display adapter. 

Price includes all major and minor upgrades through version 2.0 via 
electronic distribution. 

(SBEBASIC) Our Price $69 

CodeBuilder M 'TENON 

by Tenon Intersystems /rf/ intersystems 

CodeBuilder is a powerful and unique Macintosh software 
development tool for porting existing apps or developing new, 
advanced applications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C, C-i-u, 
Objective-C, Java, Ada, and Fortran development tools. 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, and 
C, C-u-H, Ada 95 and Fortran 77 

• Web & internet scripting tools: Perl, MacPerl, tcl/tk, bash, sh, 
and csh 

• Supports Rhapsody kernel APIs and Rhapsody TCP sockets 
(SMIOCODEB) 0urPrice$149 



Guide Composer"' 1.2 

by StepUp Software 


STIP"” 

SOFTWARE 


• Create powerftjl Apple Guide help systems for any new or existing 
Macintosh application 

• Provides a WYSIVt/YG development environment; Guide content is 
developed in Guide windows 

• Design topics, phrases, and panels in the same format as the user 
will use them 

• Features are WYSIWYG interface. Topics, phrases, and 
hierarchical phrases, Coach marks, Fully-Integrated with Apple’s 
Guide Maker (distributed with Guide Composer), compiles scripts 
automatically, PICTs in Panels, Generated Guide scripts are modifiable 

• FREE Update to all registered Guide Composer users. Demo is 
available at http://wvm,guideworks.com/ 

(SGCOMP) Our Price $99 


SEE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman’s 
AppleGuide Starter Kit, Real World AppleGuide 


B-Tree HELPER 2.2 

by Magreeable Software 

• Inexpensive database engine 
for Macintosh programmers 
in C source code 

• Uses contiguous fixed length 
blocks 

• Expands the tile as necessary and contacts files when 
possible 

• Inserts and deletes keys in one or more B-Trees 

• Finds keys equal to, less tian, or greater than a given value 
in a few hundredths of a second 

• Finds lists of records whose keys are equal to, less than, or 
greater than a given value or are in a range of values 
(SBTREE) Our Price $149 




BBEdit 4.5 

by Bare Bones Software 

BBEdit 4.5 is a powerful, easy-to- 
leam text and FTTML editor that 
offers developers and HTML 
authors the ability to build on its 
core functionality to suite their 
specific needs through its plug-in architecture and scripting 
capabilites. This new version includes: a visual table tool that 
speeds page and site development, contextual menu support for 
Mac OS 8, improved storage for 'grep' patterns, scriptable HTML 
authoring preferences and more. It still provides: unparalleled 
searching muscle with support for both 'grep’ style and advanced 
literal searches, the ability to quickly compare differences 
between files or entire folders, integrated support for Symantec's 
iOE, Metrowerks CodeWarrior, THINK Reference 2.x, MPW 
Toolserver and most other environments and a heck of a lot more. 
(SEBEDIT) Our Price $119 


Step-Up Installer Pack 

by StepUp Software 

• Package of several Installer '‘atoms" that let developers incorporate 
graphics, sounds, file compression and custom folder icons Into 
installation scripts 

■ Compression formats supported are Compact Pro & Diamond 

• Each atom also available separately 

• Compression requires additional licensing 
(SINSTALL) Our Price $219 

ScriptGen Pro 

by StepUp Software 

• Installer script generator which requires no programming or 
knowledge of Rez 

• Supports StepUp’s InstallerPack, Stuffit decompression, Compact 
Pro decompression, custom packages, splash screens, network 
installs, and resource installation 

(SSCRPTGEN) OurPrice$169 
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BeSpecific 3 VIV/^ 

(Third in a series) 

byAdamation 

The best-selling BeSpecific CDROM series 
provides the best in BeOS 
shareware across a wide range of 
application areas, including: 

• Productivity programs • Latest source code 

• Programming tools • Graphics Games 

• Commercial demos 

• Newsgroup archives (comp.sys.be} Developer mailing list (Be DevTalk) 
BeSpecific 3 is brimming with useful BeOS Preview Release-compatible 
software, A "must have" companion for all users of the BeOS. 
(SBESPEC) Our Price $39.99 




Pilot Attache DiskI 

(First in a regular series) 

by Adamation 

The Pilot Attache CDROM, designed forW 
popular US Robotics Palm Pilot organizer 
provides you the best in Piiot shareware. 

Extend your Pilot’s capabilities across a 
wide range of application areas, including; 

• Personal productivity tools • Newsgroup information 

• Programming tools • Games 

• Utilities 

Fully tested, Pilot Attache’s shareware treasure throve will help you 
get the most out of your Palm Pilot. When you travel with your Pilot, 
don't forget your Attache, Pitot Attache ..your passport to success. 
(SPATCHE) Our Price $29.95 


Water's Edge Software 



Tools Plus libraries + 
framework 

by Water's Edge Software 

Easily create compact, fast running, 
professional looking applications and plug-ins*. 
Tools Plus lets you create virtually any user 
interface element with a single routine, and it 
transparently provides a robust infrastructure to 
make all your pieces work together as an 
application. 

• Simplifies programming and thins source 
code 

• Automates all standard GUf elements 

• Thousands of extras, from floating palettes 
and tool bars to powerful picture buttons 

• Includes numerous 3D grayscale options 


• Over 1/2 MB of custom fonts, icons, 
cursors, and other resources 

• Includes SuperCDEFs world-class controls 
(an $89 value) free 

(STOOLCW) Our Price $249 

CodeWarrior Gold 

(C/C-H- & Pascal, 68K & PPG) 

(STOOLCWB) Our Price $199 
CodeWarrior Bronze (C/C-n- & Pascal, 68K) 

(STOOLSYMT) Our Price $199 
Symantec (THINK) C/C++ and THINK 
Pascal (68K) 

(STOOLSYM) 0ur Price$149 
Symantec (THINK) C/C++ (68K) 

(STOOLPAS) Our Price $149 
THINK Pascal (68K) 

‘CodeWarrior required to write plug-ins 


AppMaker 

by Bowers Development 

• Develop the user interface for a Macintosh application 
using the original interface builder 

• Just point and click to design your application 

• Creates resources and generates excellent source code 

• Supports most development environments including 
Metrowerks, Symantec, or MPW; C, C++, or Pascal: 
procedural or object-oriented, using PowerPlant, TCL, 
or MacApp 

• The generated code uses the Universal Headei^ to provide PowerMac compatibility 

• Great tool for beginners to learn object-oriented and Macintosh Toolbox programming 
techniques 

• Includes one-year subscription on CD and h^copy documentation 
(SAPPMAKE) Our Price $299 


AppMaker 





o 
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Tesflh’ack-Bug Ifacking 
the Macintosh Way 

by Seapine Software, Inc. 

• Tracks bugs, feature requests, test 
configurations, users, and more 

• Includes notifications, security, a 
powerful filter mechanism, and 
multiple reports 

• Links your testers, engineers, 
documentations staff, and project 
managers together to ensure alt bugs 
are identified, fixed, and documented 

• Eliminates the need to build custom 
bug tracking solutions using general 
purpose database tools 

• Supports single- and multi-user bug 
databases (additional licenses 
required to use multi-user features) 
(STETR) Our Price $129 


Web site: http://www.devdepot.conn • E-mail: orders@devdepot.com 
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SuperAnalyst 

by SuperSoft 
SuperAnalyst Is an 
easy-to-use data 
analysis and plotting 
application written 
specifically for the 
Apple Macintosh 
computer and 
PowerPC. It provides a 
wide range of X-Y plotting and analysis capabilities at a click of the 
mouse. It is easy to use and provides interactive control of the 
appearance of almost every characteristic of your plot. You can 
overlay multiple plots on the same graph, and the number of 
points is limited only by the memory of you computer. 

• 16 Plot Types; Scatter (Box and Cross), Line (with and without 
symbols), Function, Log-Log, Semi-Log, Double Y, Bars, 

Columns, Stacked Bars, Stacked Columns, Area, Pie, Polar, and 
Histogram. 

• Function Plots: Plot mathematical equations you can input 
without constant reference to the manual. 24 intrinsic functions 
(cos, sinh, exp. In, sqrt. erf, bes, gam. etc.}. 

• PLUS, set templates, reads many tile formats, smooth, filter, and 
sort data, modify data, error bars, function and data integration. 
FFT tranforms, curve fits, etc. 

(SSANAL) Our Price $99 
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SuperPiot 

by SuperSoft 

SuperPiot is a plotdng library which can 
be linked and called directly from 
programs written in either Fortran. 

Pascal, or C. SuperPiot provides a simple 
way to plot data generated by your program, edit ttie plot, and then 
print, export, and/or save the plot for future reference. 

A simple subroutine or procedure call hides your applications menu 
bar. puts up SuperPlot's menu bar, creates a new window, and plots 
your data. It provides you with complete control of ihe appearance of 
your plot using the mouse, menus, floating palettes and dialogs. 
Preparing presentation quality graphs of your data was never easier. 
SuperPiot runs on either the PowerPC or 68 K computers. 

(SSPLOT) 0urPrice$195 



SuperPlotPRO 

by SuperSoft 

• Plotting data from your program was never easier 

• A Plotting and Chart Library callable from Fortran, Pascal, and C 

• Plot Types: Scatter, log-log, x semi-log, y semi log, Odouble Y, 
cross, line, line w/ symbols, bar, stacked bar. column, stacked 
column, area, pie, polar 

(SSPLOTPRO) Our Price $295 


QUED/M 3.0 

by Nisus Software 

• The programmer's texl editor that defined the 
industry s^dard for speed and efficiency 

• PowerPC native 

• Features integrated support for Symantec 
C/C+-r, Metrowerks CodeWarrior 6, and MPW 

• Supports ail the map development environments on the Macintosh. 

• Powerful editing features, including unlimited undo and redo, maao 
language, scripting, text folding, ten editable/appendable clipboards, 
markers, dl^laying text as ASCII codes, dynamic coloring of C/C-h- 
keywords/comments, rect^gular and non-contiguous selection 

• Includes Celestln Company’s APPRENTICE 4 
(SQUEDM) Our Price $89 


AG Author 

by Lakewood Software 

AG Author 1.0 is a full-featured Apple Guide authoring tool with 
fully customizable project template. The following features are 
unique to AG Author: 

• Support tor styled, colored, & hot text 

• Fully customizable project template 
■ Flexible compile options 

• Find & replace tool for scripts 

• Multiple open projects 

• Rapid deployment of project globals 
(SAGA) Our Price $99 

SEE RELATED PRODUCTS: AppleGiiide Complete, Danny Goodman's 
ApptoGuide Starter Kit Real World AppleGulde 



Web Ware 

by BeachWare, Inc. 

The ultimate collection of clip media and templates 
for building your own Web Page. An incredible 
selection of Shockwave movies, animated GIFs, 
buttons, bullets, dividers, and sample HTML pages. 
There are literally thousanrte ot graphical elements on this disc, all there 
to spice up your web page. In all, it’s about 380 megabytes ot creativity 
only a mouse-click away! System Requirements: PC - 486 or better with 
8 MB RAM. Sound card, SuperVGA, CO-ROM drive. Macintosh - Color 
Mac with 8 MB RAM, CD-ROM drive. 

(SWEBW) Our Price $24.95 


SofIPolish CD-ROM 

by Bare Bones Software 

• The essential tool for software quality 
assurance on the Macintosh 

• Helps you identify inconsistencies with 
Apple's user interface guidelines, 
misspelled words, missing resources, 
and other misQkes 

• Provides tools to put the finishing touches on software distribution 
packages prior to release 

• Works independently of any programming language or environment 

• Ideal for sanity checking software throughout the development process 
(SSOFTPOL) Our price $99 
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VText 

by Vivistar 

VText is a C++ add-on library for 
Metrowerks’ PowerPlant application 
framework. VText provides complete 
Macintosh text support including: greater 
than 32kb text, undo, drag and drop editing, 
AppleEvent scripting and recordabillty, full 
support for multibyte characters and inline 
input methods including Japanese and Chinese text, and full support 
for bi-directional script systems including Arabic and Hebrew. 

• Full featured text engine for Metrowerks' PowerPlant 

• Stylesets and ruiersets with tabs 

• Flexible object oriented C++ API 

• Full undo and drag and drop editing 

• WorldScript sawy including bidirectional and multibyte scripts with 
inline editing 

• AppleEvent factored for scriptability and recordabillty 
(SVTEJOl Our Price $349 


OpenGL for 
the Macintosh 

by Conix Graphics 

OpenGL is the premier 3D graphics library that allows software 
developers the ability to develop high-quality, interactive 2D and 3D 
graphics applications. OpenGL can perform the following wide range of 
functions wtiich will enhance the development of all graphics software: 

• Geometric primitives ftioints, lines, and polygons} 

• RGBA or color index mode 

• Viewing and modeling transformations 

• Texture Mapping, Lighting, Shading and Z Buffering 

• Atmospheric Effects (fog, smoke, and haze) 

• Alpha Blending (transparency) 

• Antialiasing, Accumutafion Buffer, Stencil Planes 

• Display list or immediate mode 

• Polynomial Evaluators (to support Non-unitoim rational B-splines) 

• Feedback, Selection, and Picking Raster primitives (bitmaps and 
pixel rectangles) 

• Pixel Operations [storing, transforming, mapping, zooming) 
(SOPENGL) Our Price $389 
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Bee-one 

C-tree Plus® Database Handler 
Compilelt! 

CONIX PowerTools-10 PacK 
CPU Doubler 
DesignWorXs 4,0 
dtf 

EtherPeek 
Fortran 77 SDK 
ICONIX PowerTools-6 Pack 
ICONIX PowerTools-8 Pack 
ICONIX PowerToots-AclaFlow 
ICONIX PowerTools-ASCII Bridge 
(CONIX PowerTools-CoCoPro 
ICONIX PowerToofs-DataModeler 
ICONIX PovtferToois-FastTask 
ICONIX PowerTools-FreeFlow 
ICONIX PowerTools-Object Modeler 
ICONIX PowerTools-PowerPDL 
ICONIX PowerTools-QufckCriart 
ICONIX PowerTools-SmartChart 
ICONIX Training Si Consulting 
IMSL Malti and Stat Library 
InFo-Mac X 

Ionizer Real-Time Spectral Reshaping Tool 
LiveAccess^^ 1 User Edition 
LiveAccess^ 1 Developer Edition 
UveCard 
U Profiler 

MacFlow": Flowchart Design and Development 
Mac Source II 
Nisus Writer 5.0 

Plan Si Track™: Project Planning and Management 

Phyla™: Object-Oriented Database 

r-tree Repori Generator 

Speliswell Pius 2A 

Spyer 

Visual Cafe 


CODE 

OUR PRICE 

SBEEONE 

139,00 

SCTPDH 

895.00 

SCOMPIT 

149,00 

SiCPPlO 

7,845.00 

SCPU2X 

79.00 

SDWORKS 

995.00 

SDTF 

695.00 

SFPEEK 

745.00 

SF77 

699.00 

SICPP6 

5,345.00 

S1CPP8 

6,945.00 

SiCADA 

1,395.00 

SICASCil 

1,395.00 

SICCOCO 

1,395.00 

SICDATAMOD 

1,395,00 

SICFASHASK 

1,395.00 

SICFREEFL 

1,395.00 

SICOBJMOD 

1,395.00 

SICPOWER 

1,395.00 

SICQUICKCH 

1,395.00 

SICSMART 

1,395.00 

ncoNix 

2,945.00 

SIMSiSTAT 

495.00 

S1NFOMAC10 

39.95 

SIONIZER 

800.00 

SLAUE 

69.00 

SLADE 

99.00 

SLCARD 

149.00 

SUPROF 

295.00 

SMACaO 

179.00 

SMACSOURCE 

29.95 

SNISUSW 

220.00 

SPLTJTRK 

179.00 

SPHYLA 

179.00 

SR-mc 

445.00 

SSPELL 

49.00 

SSPY 

39.00 

SVCAFEMAC 

199.00 


V/A®^*** - 

i products. For full product descriptions please see our Web 

site, or feel free to call, fax, or E-mail us. 

PRODUCT 
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WebTen 

by Tenon 
intersystems 



WehTen is an 
industrial-strength, 
high-pertormance 
Apache Web server for 
Power Macs. WebTen's 
Web-based browser 
interface enables local 
or remote administration via your favorite browser. Since Apple's NeXT 
acquistion, Tenon has extended their unique “UNIX virtual machine” 
technology to produce a set of “Rhapsody-Ready” internet 
applications. WebTen is the first offering in this series. 

• WebTen is the fastest Web server on Power Macintosh 

• Sustains up to 10,000 connections a minute, or over 10 million 
connections a day 

• Apache runs in Tenon’s multi-threaded, pre-emptive 
multitasking environment 

• Tenon’s unique technology supports the widely acclaimed Apache 
Web server as a double-clickable Macintosh application 
(SWEBTEN) Our Price $495 


BBEdit 4.5 

by Bare Bones Software 
(SBBEOIT) Our Price 

$119 

Also see Tools, Libraries and 
Utilities, page 8 


webAlias 1.0 

by Lakewood Software 

webAlias 1.0 is an 
integrated image map 
editor and anti-aliasing 
text toot for web and 
graphic designers. Use 
webAlias to create 
complete web sites, 
single web pages, and graphic content for multimedia and web 
design projects. webAlias integrates support for line, shape, free 
form, field and button objects. webAlias’ anti-aliasing features 
includesupport for embedded picture and gradients in text, as well 
as multiple shadow and highlight effects. 

(SWEBALS) Our Price $129.95 




PageCharmer: Sizzling Effects... 



PageCharmer 1.0 

by Mainstay 

PageCharmer is a set of customizable interactive applets that 
enhance web pages without writing a single line of HTML code. 
Whether the web site Is already up and running or designing one 
from scratch, PageCharmer gives you the power to make it stand 
out from the crowd with sophisticated applets that can be 
personalized to fit most any need. 

FEATURES: 

LiveG-Map, LiveT-Map, LiveG-Button, LiveT-Button, LiveGT-Button, 
LiveG-Tlcker, LiveT-TIcker, LiveG-Marquee, and UveT-Marquee. 
(SPGCHRM) Our Price $139 


ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C+-I- classes for integrating 
Internet e-mail in your applications 

• Helps you write software that can share 
mail with other leading e-maii products 

• Royalty-free MIME, SMTP, and POP3 APIs 
for Macintosh, Windows, and Unix 

• Gives you the most robust MIME parser and encoder available 

• Ideal for use in Internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 



HyperGuide 1.0 

by Lakewood Software 

Hi^erGuide 1.0 is a hybrid 
multimedia authoring tool and 
on-line documentation 
system for the Macintosh and 
World Wide Web. HyperGuide 
provides integrated 
searching, indexing and 
bookmarking features. 

Supported media elements 
include: rectangle and 
scrolling fields, lines and shape fills, most QuickTime-supported 
image formats, anti-aliased text and QuickTime VR movies. 
HyperGuide also includes an integrated screen capture utility and 
user-configurable slide show mode. 

(SHYPGUD) Our Price $149.95 
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Roaster 

by Roaster Technologies, Inc. 
(SR0AST3} Our Price $99 

Also see Development 
Environments, page 5 
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Rumpus 

by Maxum Development 

Maxum’s nevt, high- 
performance FTP server for 
the MacOS. Based on 
Maxum's RushHour TCP/IP implementation, Rumpus 1.0.1 offers 
the performance and reliability of high-end workstations with the 
ease of use, security, and flexibill^ of the Macintosh. 

• Simplified setup, with no need to contigure AppleShare, File 
Sharing, or Users & Groups for simple anonymous FP 

• Anonymous and/or secure server access, with separate 
security settings for anonymous vs. secure users 

• Automatic MacBinary and Binhex encoding 

• Complete logging, with separate anonymous and secure 
access logs, including anonymous user passwords 

• Up to 32 simultaneous connections 
(SRUMP) Our Price $195 



Power MachTen 4.0.3 

by Tenon Intersystems 

MachTen is the only Macintosh product that can turn your 

Macintosh into a complete Unix workstation. Based on 

3SD4.4 and the Mach kernel, MachTen brings the power 

of Unix to your desktop at an extremely attractive price point. 

MachTen enables you to; 

• Run a high speed internet server, complete with WWW, FP, NFS, 
DNS and print service 

• Build a Mutibomed Web Server 

• Develop applications in a Unix development enwonment, replete 
with the acclaimed GNU development toolset 

• Program in Ada. C. C-r-t-, Pascal. Fortran, and more 

• Run Xwindows applications, from remote workstations or on 
your Macintosh 

• Run hundreds of Unix applications, afready ported for MachTen 
and available on our Ported Applications CD-ROM 

• Run Soflware.oom Inc’s acclaimed Post-Office mail transport service 
(SM10PPC) Our Price $695 


CGi Toolkit 

by Pictorius Inc. 

The Pictorius CGI Toolkit Is the fast and 
easy route to high performance CGIs 
and ACGis for your Mac Web site. 

•Interactively develop CGIs while the 
web server, the CGI Toolkit and the browser are running on the 
same machine 

• Interactively develop, test and debug CGIs before compiling 

• Powerful debugger allows you to edit code, roll back, code and 
change input values while your application is running 

• Fully object oriented so you can re-use your code 

• Automatic handling of Apple Events so you can concentrate on 
building functionality 

• Easy creation of multi-function CGIs which reduces application 
footprint and RAM usage 

(SCGITLKTj Our Price $149 




Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 

PRODUCT CODE OUR PRICE 

OOFILE Reporter Writer SOORW 499.00 

ScriptDemon SSOEMON 949.00 

WebSiphon SWSiPHON 495.00 



Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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FaceSpan v2.1 

by Digital Technology International 

•Develop integrated software, make stand 
alone applications, create friendly 
interfaces 

• Develop quick prototypes, print multiple 
pages with sophisticated layouts 
•Script essential elements of the FaceSpan 
application - Enhanced save options 

• Play and record sounds as either “snd" resources or as "AIFF" files 

• Create miniature or complete apps that run on either Power PC or 
68k computers 

• Lise precise time measurement for implementing timed behaviors 
— New properties 

• Proportionally scale PICT images -Align images in a pictbox - 
Automate any application 

• Monitor and respond to tow-memory situations-lncreased support 
for Frontier UserTalk! 

(SFACESPAN) Our Price $299 



PreFab Player 

by PreFab Software, Inc. 

PreFab Player is a faceless background application (similar to a 
system extension) that lets your scripts query and control otherwise 
non-scriptable applications, desk accessories and control panels. 
Player adds verbs that directly manipulate the Macintosh user 
interface: choose from menus & pop-ups, select radio buttons, type 
text, determine the name of the frontmost window, the state of a 
check box, etc. Balloon help identifies non-standard dialog items. 

• Adds verbs to AppleScript and to Frontiers UserTalk 

• Controls the Frontmost Application 

• Balloons Identify User Interface Objects 
(SPLAYER) Our Price $95 



Scripter 2.0 

by Main Event Software 

For professionals, for novices, for 
webmasters, for solutions providers, there's 
only one serious choice. Scriptert 
• Scripter and FaceSpan work together; one 
click opens your FaceSpan script in 
Scripter, another sends it back 

• Debug handlers witiiout modifying your scripts using the Call Box 

• Applet simulation, live editing, Object map, associated terminology 

• Search backwards, block generators, more navigation shortcuts, 
more drad-and-drop, and an even more enhanced trace log 

• Now Includes ScriptBase; stores your data and media elements 
and share them between scripts all with a special new browser 

• Easily write and compile scripts that have handler declarations 
and other vocabulary specific to a particular scriptable application 

• Scripter is the natural companion to AppleScript for users at ail 
levels of proficiency. Don’t write scripts without it! 

(SSCRIPTER) Our Price $199 


AppleScript Software 
Development Toolkit 1.1 

by Apple Computer, Inc. 

• AppleScript language, system software 

extension, and script editor V' 

• FaceSpan 1.0 J 

• Developer’s redistribution license for \^' 
AppleScript System software extension 

and FaceSpan runtime code 
(SASD7) Our Price $49 



Script Debugger 

by Late Night Software Ltd. 

• A powerful and flexible AppleScript 
authoring tool - get the most from 
AppleScript! 

• Advanced debugging environment offers 
single-step script execution with 
breakpoints 

• Script Debugger dictionary browser 
features a graphical view of objects provided by scriptable 
applications 

• Includes Late Night Software Scripting Additions - a collection of 
more than 70 new AppleScript commands, and Scneduler, a utility 
that allows you to launch scripts at pre-determined times 
(SDEBUG) Our Price $129 


TCP/IP Scripting Addition 

by Mango Tree Software 

•Award-winning AppleScript scripting 
addition 

•Allows you to write scripts using 
MacTCP^M commands in AppleScript™ 
•Send e-mail or Hies through a script, 
check if users are logged on (via Finger), automate FTP. Gopher, 
NetNews, Telnet, and LPR, verify links in HTML documents, and 
quickly write many other TCP/IP client-server programs 
• Works with AppleScript. MacTCP 2.0.4 and Open Transport 
(STCP) Our Price $49 
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WindowScript 

by Royal Software, Inc. 

WindowScript is the ultimate tool for designing Macintosh user 
interfaces using HyperCard. Design Beat “Macintosh" user- 
interfaces right inside HyperCard. Until now you either created 
HyperCard stacks or Macintosh applications. With WindowScript 
you can literally bring the look and feel of a real Macintosh user- 
interface to HyperCard. If you're a HyperCard developer, interface 
designer, application developer, program manager or tester 
searching for a prototyping tool, WindowScript is perfect for the job. 
(SWSCRIPT) Our Price $149 
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auickTime VR 2.0 
Authoring Tools Suite 

by Apple Computer, Inc. 



• QuickTime VR is a cross-plattorm software 
from Apple whicfi enables webpage 
designers and professional developers to 
create new multimedia products and 
webpages incorporating QuickTime VR 
content. With QuickTime VR, users 
interactively navigate through 360° views 
of space, and explore three dimensional 
objects on Macintosh or Windows-based 
personal computers 

• The QuickTime VR Authoring Tools Suite Is 
a set of Macintosh tools to create and link 
panoramas and objects from 


photographic, digital, video, or computer 
generated images 

• Included is a complete set of 
documentation for planning, designing, 
photographing, and creating QuickTime VR 
panoramas and objects. The authoring 
tools also allow you to link objects to 
panoramas using clickable hot spots 

Included on the CDs are: 

• A software tool (MPW-based) that stitches 
and blends adjacent images into a 
panoramic PICT file 

• A software tool (MPW-based) that dices 
and compresses panoramic PICT files to 
less than 100 KB (low resolution) per 
panorama 


• A scene editor (HyperCard-based) to 
create QuickTime VR scenes by adding 
and positioning nodes, hot spots, linking 
nodes together, and for linking QuickTime 
VR objects to xenes 

• A variety of utility tools for formatting the 
data into the runtime sottware 

Due to a revolutionary distortion-correcting 
algorithm, QuickTime VR panoramas and 
objects maintain a normal perspective when 
the user moves the mouse. The speed of the 
algorithm allows up to 24-bit color images. 
Both vertical and horizontal panning can 
occur at fast speeds. 

(SQTVRATS) Our Price $395 


Apple Media Tool Programming Environment 2.1 

by Apple Computer, Inc. 

• This object-oriented language and application framework allows 
programmers to customize features used within the Apple Media 
Tool authoring environment 

• Includes an expanded Apple Media Language (AML) class library, 
incremental compiling and linking of AML code, faster debugging 
facilities, Macintosh Programmers' Workshop (MPW), and user-oriented 
documentation written from an AMTPE developer’s perspective 

• Portable across 68K, Power Macintosh, and Windows platforms 

(SAMTPE) Our Price $995 


Multimedia Authoring with Apple Media Tool 

by Apple Computer, Inc. 

Apple Media Tool offers new multimedia users a way to get started 
creating interactive multimedia with minimal learning time. This seif- 
paced tutorial will make Apple Media Tool {PM\} even easier to 
understand and to use. Using this tutorial, you will create a realisUc 
multimedia project using exciting techniques such as QuickTime 
movies, animation and more. A demo version of AMT is included and 
can be used for the exercises. Training Format: Tutorial with labs. 
(SMWAMT) Our Price $49.95 



Virtual Reality 
Programming 
with QuickTime VR 2.0 


by Apple Computer, Inc. 

• Virtual Reality Programtning Book/CD-ROM 
tor QuickTime VR 2.0 

• Enables you to write C and C-h- programs 
using QuickTime VR 2.0 

• Allows QuickTime VR to be used in 
games, multimedia titles and other 
programs 

• QuickTime VR 2.0 objects can be zoomed 
In on, panned, or linked with hots spots 

• Both panoramas and objects have hot 
spots linked to World Wide Web URLs 
(SVRPQT) Our Price $49 



Clip VR"* 

by eVox Productions 


Clip VR" is a new digital image library 
ottering high quality Photogr^hic Virtual 
Reality (PVR) (mages for use with Quicktime*' 
VR and other desktop VR tools. 

Qip VR'“ Panoramic Image components indude 
alpha channel made. Combine elements into a 
composite panorama which is converted to the 
finished QuickTime VR movie using Md<e Q1VR 
Panorama Tool. The Components (“Clips") 
include complete 360 degree scenes, 
libraries of 360 degree terrains, 360 degree 
skies, buildings, and objects, images are 
provided as .PICT files AND QuickTime VR 
movie files. Clip VR’’“ allows you to create 
high quality VR worlds from pre¬ 
photographed component images. Clip VR'^^ 
can be used to add excitement to a web site, 
to increase the interactive value of a CD- 
ROM, or simply for fun! Requires imaging 
editing program such as Adobe Photoshop" 
to perform .PICT image compositing. 
(SCLIPVR) Our Price $89.95 



Screen Machine 

by BeachWare, Inc. 

Personalize your computer screen 
wlfri this dynamic and useful collection of 
Screensavers and Wallpapers, Choose from 
over 100 original Screensavers such as 
flying airplanes, bouncing coffee cups, falling 
climbing gear, shifting psychedelic patterns. 
Of floating spaceships. Customize your 
computer desktop with over 150 exciting 
new wallpapers such as sand, rocks, cloth, 
coins, cartoons, or unique patterns. Included 
is an easy to use browser program that Sets 
you sample all of the Screensavers and 
Wallpapers before installing them on your 
computer. 

(SSM) Our Price $24.95 


Web site; http://www.clevdepot.com • E-mail: orders@devdepot.com 
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Magellan QC 

^ if^ by Kaidan 

I fHE Magellan is capable of 

I handling objects as large as six 

I inches in diameter and five 

* pounds in weight, the Magellan 

QC is the perfect choice for 
those needing to capture 
small objects at a 
reasonable price. Real- 
world objects can be 
turned into 3-D virtual 
reality movies using the 
Quicklime VR Authoring 
Studio and the Magellan QC. 

The Magellan QC leverages the capabilities of 
the Connectix " Color QuickCam" digital camera for QTVR object 
capture. The Color QuickCam's close focusing capability (one inch 
to infinity), 640 x 480 resolution, serial interface (no video card 
required], 24-bit color support, convenient size and low (x^t make It 
an ideal camera for many simple QTVR object movies. Using the 
Magellan QC is easy. Simply locate the object on top of the 
adjustable pedestal, perhaps with a small piece of double-sticky 
tape, and then adjust the arms and pedestal so that the center of 
the object is centered in line with the camera and the rotation axis 
of the swingarm. 

(HMAGQC) Our Price $299.95 




QuickPan Magnum 

by Kaidan 


The QuickPan Magnum Series consists of two models, the QPX- 
1 and QPX-2. Featured on both models is the new QPU-2 
camera bracket. Based on the highly successful KiWi, it provides 
a sturdy, collapsible system for the mounting and adjusting of a 
wide variety of cameras and camcorders. The new base designs 
used on the Magnums are a refinement of our earlier bases, 
with the QPX-1 having a fixed base and the QPX-2 having a new 
low-profile micro-tilt adjustment stage. The easily adjustable 
click-stops will let you capture a panorama in a few seconds. 
The QPU-2 has two accessories, a Landscape Bracket for 
positioning the camera in the landscape orientation (OPLB-1) 
and a Counterweighting Kit (QPCW-1) used to balance large 
cameras or camcorders, such as the Sony VX-1000, that have a 
center of mass well behind the pivot axis. 

QuickPan Magnum-I (HQPMAG1) Our Price $499.95 
QuickPan Maghum-2 (HQPMAG2) Our Price $549.95 


Magellan Accessories 


Magellan QC Pedestal Set 

Two extra pedestal tube assemblies, one 2.5“ and another 6" 
long. These extra pedestal tubes are used to support objects of 
varying sizes on the Magellan QC. 

(HMAGPED) Our Price $39.95 


QuickPan Magnum Accessories 


Counterweighting Kit 

The Counterweighting Kit includes a weight and adjustable ann 
that is used to offset the weight of large, heavy cameras and 
camcorders. 

(HWKTKT) Our Price $129.95 



Magellan QC Detent Wheels 

A pair of optional detent wheels (Color = Gold) with 8 (45 
deg). 12 (30 deg). 14 (25.7 deg), 16 (22.5 deg) and 18 (20 
deg) settings. The standard wheels (Color = Aqua) provide 10. 
15,20,24 and 36 positions. 

(HMDWHLS) Our Price $74.95 


Older Toll-free 
800-MACDEV-1 

(8(10622-33lll| 


Detent Wheel 

Detent Wheel (5-inch) (Color = Purple); 10,14.18.24 and 30 
Position {QPDD-2) 

(HQDWHLS) Our Price $49,95 

QuickTilt Leveler 

A leveling stage, similar to the one found on our QuickPan 
Magnum OPX-2. that mounts between your panhead or camera 
and your tripod. It makes the leveling process quick and easy. 
Particularly useful when you plan to shoot a number o1 
QTVFWR nodes in a short period of time. 

(HQTLVLR) Our Price $149.95 
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KiWi 

by Kaidan 

The KiWi^M 
is the most 
affordable VR/QTVR 
panhead, bringing digital 
photographic panoramas 
to an even wider audience. It's 
the perfect companion to programs 
such as QuickTime VR Authoring Studio, PhotoVista and Nodester, 
providing a complete solution for anyone interested in adding VH 
panos to their websites and multimedia applications, 

The KiWi™ consists of two intersecting black anodized aluminum 
struts that adjust and lock to accommodate a wide range of 
cameras, such as the Apple QuickTake 100/150/200, Kodak 
DC50/120, APS film cameras and 35mm SLRs equipped with wide- 
angle lenses. KiWi™ attaches to any standard tripod and camera 
equipped with a standard 1/4-20 mounting thread. 


(HKIWI) Our Price $99.95 




by Kaidan 

The KiWi-i- adds a compact, yet durable click-stop mechanism 
and the same twin-axis bubble level found on the top-of-the-line 
QuickPan Magnum Series heads. The twin-axis bubble level 
{recommended by Apple and VR professionals) provides a clear ! 
indication of level, even when the unit is slightly above eye level, ; 
The click-stop mechanism uses easily replaceable detent discs, 
which are available in a number of positions (8,12,16,18,20), ; 

The KiWi-f- ships with one disc of your choice and extra discs are 
available separately or as a set. The click-stops speed the 
process of shooting a panorama by eliminating the need for the ^ 
photographer to look at the unit in order to visually align the 
index increment. 

(HKIWIP) Our Price $249.95 


KiWi and KiWi+ Accessories 


QuickTilt Leveler 

A leveling stage, similar to the one found on our QuickPan 
Magnum QPX-2, that mounts between your KiWi or KiWi-f and 
your tripod. It makes the leveling process quick and easy. 
Particularly useful when you plan to shoot a number of QTVR/VR 
nodes in a short period of time, 

(HQTLVLR) Our Price $149.95 

KiWi-to-KiWi+ Upgrade 

Includes the necessary parts required to turn your KiWi into a 
KiWi-(- — adding click-stops and the twin-axis bubble level, Comes 
with a detent disc of your choice (8,12,16,18 or 20 positions). 
(HKIWIUP) Our Price $199.95 

KiWi+ Detent Discs 

KiWi-i- Detent Discs are available singly or in a set of four. In both 
cases you get to choose whichever discs you need. 

(HDTDtSC) Our Price $24.95 


Landscape Bracket 

The Landscape Bracket is a right angle bracket that allows you to 
mount the KiWi or KiWi-n upright camera bracket in a horizontal 
orientation. This bracket is primarily used for cameras that have a 
limited field of view and you need to limit the number of shots. 
(HLDBRAC) Our Price $42.95 | 

Flash Hotshoe Level 

A dual-axis bubble level that slides into your camera’s hotshoe. tt's a 
useful too! to help level the camera on the upright camera bracket. 
(HFLASH) Our Price $39.95 j 

j 

Offset Spacer 

The Offset Spacer is a circular spacer that may be required for j 
very narrow cameras (i.e, certain Ricoh digital cameras) in order | 
to position tie center of the lens over the pivot axis. 

(HOFFSPAC) Our Price $24.95 
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Be Studio 

by BeatWare 

Developed specifically for the 
BeOS, Be Studio is the first 
graphics application to offer 
full multithreading for 
unbelievable responsiveness 
and unbeatable speed. Be 
Studio includes Paint for 
editing photos or creating 
original artwork and Draw, a 
vector-based tool for 
drawing crisp designs and prints. Be Studio offers the BeOS 
developer the ability to; 

• Design application icons quickly and easily 

■ Edit and export images easily to the World Wide Web 

■ Manipulate several images at once without degrading performance 
> View updates from a variety of perspectives simultaneously 

• Import and Export images as GIF, JPEG, PNG, TIFF, and PNM files 

• Plug-in third party tools and filters 

Be Studio requires the BeOS. 16 MB of RAM {32 recommended). 
3MB available hard disk space and a 256-color display adapter. 
Price includes all major and minor upgrades through version 2.0 via 
electronic distribution. 

(SBESTUD) Our Price $99 

Order Tell-free 
800-MACDEV<1 

tIM52-338lt 


□bouf 
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Music Wacks 

by BeachWare, Inc. 

A new PC/Mac & Audio multimedia music 
CD-ROM. The clips include musical 
introductions, fanfares, background music, 
and more. This collection offers you 100 
music clips stored in .WAV format for 
Windows. SoundEdit & AIFF formats tor Macintosh and as Audio 
tracks for audio CS players. All ot the music clips are completely 
license and royatty-freel! Mac System requirements: Mac Plus or 
greater. CD-ROM drive. PC system requirements; Windows 3.1 or 
later, Sound Blaster compatible board, CD-ROM drive, 

(SMT) Our Price $24.95 




Introducing a new Audio multimedia music CD- 
ROM for the Macintosh. This disc is a colfection 
of dtps ideal for Desktop Presentations and 
other Multimedia applications. This incredible collection of license-fiee 
media dips is bursting with 2AO+ color pictures and backdrops (PlCt), 
200-1- sound & music dips (SoundEdit), 140-1- QuickTime movies, and a 
variety of multimedia tools for use with the Macintosh. 


MultiWare 

Multimedia Collection 

by BeachWare, Inc. 


(SMWMC) Our Price $24.95 


webAlias 1.0 

by Lakewood Software 

webAlias 1.0 Is an 
integrated image map 
editor and anti-aliasing 
text too! for web and 
graphic designers. Use 
webAlias to create 
complete web sites, 
single web pages, and graphic content lor multimedia and web 
design projects. webAlias integrates support for line, shape, free 
form, field and button objects. webAlias* anti-aliasing features 
include support for embedded picture and gradients in text, as well 
as multiple shadow and highlight effects. 

(SWEBALS) Our Price $129.95 


HyperGuide 1.0 

by Lakewood Software 

HyperGuide 1.0 is a hybrid 
multimedia authoring tool and on¬ 
line documentation system tor the 
Macintosh and Wodd Wide Web. 

HyperGuide provides integrated 
searching, indexing and 
bookmarking features. Supported 
media elements include: rectangle 
and scrolling fields, lines and 
shape fills, most QuickTime-supported image formats, anti-aliased text 
and QuickTime VR movies. HyperGuide also includes an integrated 
screen capture utility and user-configurable slide show mode. 
(SHYPGUD) Our Price $149.95 





Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 


CODE OUR PRICE 


AudioTrack SAUDIOTRK 270.00 

Captivate 4.6 Essential Graphics Utilities SCAPTIV 79.00 

Media Cleaner Pro SMCPUP 359.00 
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Power3D 

by Techworks 
The power of an arcade on your 
PowerPC Based on award winning 
3Dh( VooDoo Graphics. The PowerSD 
works with your existing graphics 
card and multi-sync monitor to provide you the absolute in 3D 
performance. Install the PowerSD in your PowerPC (requires one 
available PCI slot In your system) and use the provided pass-through 
cable to turn your PowerPC into a Power Arcade system! 

PowerSD comes bundled with these awesome 3D enabled games: 

• Quake**: Episode 1 (8 level) by Id Software 

• MechWarrlor® 2 by Activision 

• VR Soccer'" by VR Sports (Actua* for Europe) 

• Weekend Warrior’" by Bungle 
(SPWR3D) Our Price $249.95 


Abuse 

by Bungle Software 

Nam is 360 degrees of side-scrolling action. 

Run, jump, fall and fly in any direction - through 
industrial corridors, caverns and sewers. Destroy 
ertemles in any direction with grenade launchers, 
rochet launchers, napalm and nova spheres! Avoid 
deadly traps with jet packs and turbo boost! 

Key Features: 

• Point and Kill Irteilace. Move and annihilate mutants in complete 360° freedom 

• Blast your way through floors, walls and ceilings in search of the ultimate 
power-up! 

• Abuse is 360 degrees of side-scrolling action. Run, jump, fall and fly in 
any direction - through industrial corridors, caverns and sewers 
(SABUSE) Our Price $51 



1000 Games for 
Macintosh 

by BeachWare, Inc. 

The best Macintosh game disc in the 
entire world, this CD-ROM contains over 
one thousand great shareware and public domain programs. Battle ugly 
aliens, blast apart run-away asteroids, deal yourself that royal flush or 
solve that 3-D puzzle, this disc has it all! System requirements: Mac 
Plus or greater, CD-ROM drive, and 2 MB of available RAM (4 MB of 
RAM when running under System 7). 

(STGM) Our Price $24.95 
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Myth The Fallen Lords 

by Bungle Software 

Electronic Entatainment Expo’s Best of 
Show Awards, Most Promising New Game 
PC GAMES MAGAZINE’S, Most Anticipated 
New Game Award 


The Fallen Lords is a fully 30 real-time strategy 
game of epic battle. A multimetrlc game, Myth: 
The Fallen Lords gives gamers unprecedented 
freedom to view their forces, orbiting around tiie heads of a 
formation or zooming in for a close-up on savage melee. Myth: The 
Fallen Lords includes maps designed for networking, and alternate 
networking scenarios like Assassin and King of the Hill. 

(SMYTH) Our Price $ 49.95 


Classic Arcade 

by BeachWare, Inc. 

Ten of your favorite coin-arcade games, redone 
with killer graphics and sounds! Walk through a 
virtual arcade and test your game playing skills 
with these exciting arcade classics. Ten games, 
including Moon Lander, Astro-Boing, Hyper 
Hockey, Ballistic Avenger, and more. System Requirements: Mac - t^olor 
Mac witi 8 MB RM/I, CD-ROM drive, PC 486 with 8 MB RAM, Sound 
card, SuperVtiA,CD-ROM drive. 

(SCLA) Our Price $24.95 



Marathon Ih’ilogy Box Set 

by Bungle Software 

The Marathon Trilogy Box Set brings all three 
Marathon games together in one affordable package, 
with tons of extras thrown in. Besides Marathon, 
Marathon 2: Durandal and Marathon Infinity, you’ll also 
receive a staggering 1200 maps, featuring never- 
released Bungle maps and the winners of the Infinity 
Mapmaking Contest, The Marathon Scrapbook (a behind-the-scenes look at 
themaklng of the Marathon games), Marathon collectables like the Marathon 
3-sticker set, and to lop it off, the award-winning game that laid the 
groundwork for Marathon: Bungle's bre^hrough Pathways Into Darkness. 
The Marathon Trilogy Box Set is native to the Power Macintosh, utilizes the 
graphics acceleration of 630 and 6200 machines, is 8,16 and 24-hit color 
Cc^oabie, and can be played with joi^icks and game pads. The package 
requires a 68040 or higher Macintosh,CD-ROM drive, B-bit color monitor 
(13" recommended), and System 7 or later, 

(SMTBS) Our Price $65 
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Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-maii us. 


PRODUCT 

CODE 

OUR PRICE 

A Ziliion Sounds 

SAZS 

24.00 

Casino! 

SCAS 

24.95 

Night Sky Interactive 

SNSI 

24.00 

Trivia Warehouse 2000 

STW2K 

24.95 
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GeekWare" 

You live it, you breath it... you 
might as well wear it! (XL only) 



Alien T-Shirt 

(AALIEN) Our Price $9.95 
Arooid T-Shirt 

(ACWARNLD) Our Price $9.95 

Amoid Jr. T-Shirt 

(AARNOLDJR) Our Price $9.95 

Biood, Sweat & Code T-Shirt (SS) 

(ACWSBLOOD) Our Price $9.95 

Biood, Sweat & Code T-Shirt (LS) 

(ACWL8L00D) Our Price $14.95 

CodeWarrior Basehali Cap - Black 

(ACWBHAT) Our Price $14.95 

CodeWarrior Sweatshirt - Black 

(ACWSWEAT) Our Price $29.95 

CodeWarrior Hawaii Fhre-O Shirt 

(ACWHAWAII) Our Price $9.95 

CodeWarrior Winter Hat 

(AWINHAT) Our Price $14.95 

Debugger Boxer Shorts 

(ADBOXER) Our Price $16.95 

Discover Programming T-Shirt 

(ADISCPT) Our Price $9.95 



Podeum Sport 

by Rach, Inc. 



Now you can have laptop stability, drop 
protection & mobility. If you’re looking 
for an inexpensive, non-tecbnical gift 
for a laptop owner - look no further. 

• Strap your laptop to your leg 

• Universal size - fits all laptops and 
all tegs (13"-46") 

• Velcro Velcoins attach your laptop to the podeum 

• Podeum allows working angles up to 90 degrees 

• Dropped laptops account for 41% of all laptop fatalities 
Manufacturer's lifetime warranty. 


# 


(APODSP) Our Price $39 



MacTech® Mouse Pad 

Slide on this! With an extra-large surface (11" by 10") and 
a deluxe sleek plastic coating, you'll be zooming across 
your screen in no time at all. Speed limit not enforced! 

(AMTPAD) Our Price $8.95 
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tor Macintosh 
Programmers & Developers 



MAGAZINE 


MacTech*^ Magazine 

MacTech keeps Mac programmers & developers up to date with everything they need to 
know about software development. Topics like Rhapsody, Java, QuickTime, OPENSTEP, 

Objective-C, C/C++, Object Oriented Technologies, product reviews and much more! 

Subscriptions; 

(MTYRDM) US/Domestic for 12 issues $47 
(MTYRCM) Canadian for 12 issues $59 
(MTVRFM) Internationa! for 12 issues $97 
Back Issues; each plus shipping (subject to availability) $10 

MacTech® CD-ROM Volumes 1-12 

• Includes Apple’s ^ issues 1 -29 (1990-1997) 

• Almost 1600 articles from all 139 issues of MacTech 
Magazine (1984-1996) and through may of 1997 

• Improved hypertext, improved indices, and a new THINK Reference Viewer- 
for lightning quick access! 

• New hyperlinks between articles 

• 100+ MB of source code — use them in your applications, with no royalties! 

• Full version of THINK Reference'”—the original online guide to Inside Macintosh, Vols. I-VI 

• 80MB of FrameWorks/SFA archives and the most complete set of Frameworks archives known 

• Sprocket™! MacTech’s tiny tramework that compiles quickly and supports System 7.5 features 

• The best threads from the Macintosh programmer newsgroups plus thousands of notes, tips, 
snippets, and gotchas 

• Popular tools that Macintosh programmers use to increase their 
productivity and much more! 

(SMTCD12) Volumes!-12 Our Price $129 
(SMTCD12U) Upgrade from any previous version Our Price $49 











INSIDE MACINTOSH 









Inside Macintosh; 
CD-ROM 

by Apple Computer, Inc. 

More than 25 volumes In 
electronic form. Includes; 
QuickDraw™ GX Library, 
Macintosh Human Interface 
Guidelines. PowerPC System 
Software, Macintosh Toolbox 
Essentials and More Macintosh 
Toolbox, QuickTime and 
QuickTime Components. Access over 16,000 pages of 
information with Hypertext linking and extensive cross 
referencing. 


(BIMCD) Our Price $89 



Apple’s develop™ 
back issues are available for 
only $10 per copy. 

To place your orders, call 

800/MACDEV-1 . 


Order Toll-free 
800-MACDEV.1 


18006223381 ) 



Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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New Books! 



The Official BBEdit Book 

by Bob LeVitus and Natanya Pitts 

Tlie Official BBEdit Book makes it easy for 
today's Webmasters to speed their own 
interactive development projects using this 
powerful editing environment. Bare Bones 
incorporates features like ftoatlng palettes, 

" HTML support, and syntax coloring to 
enhance an already extensive feature set, making BBEdit a leading 
Web authoring tool. Super-fast text processing, easy scripting, wide 
extensibility, strong GREP-style search-and-replace capabilities, and 
support for 13 languages make it easy to see why so many Web 
developers use BBEdit as their primary authoring tool. 

(BOFBB) Our Price $39.99 


The Official 
BBEdit 
Book % 


Effecthre C++, 

Second Edition: 

50 Specific Ways to Improve Your 
Programs and Designs 
by Scott Meyers 

Effective C+-I-, 2nd Edition includes: Expert 
guidance on object-oriented design, class 
design, and the proper use of Inheritance 

• An examination of the standard C-n- library, including how the 
Standard Template Library and classes like string and vector affect 
the structure of well-written programs 

• Discussions of late-breaking language features like in-class 
constant initializations, namespaces, and member templates 

• Wisdom usually possessed by only the most expenenced 
developers 

• Effective C-h- continues to be essential reading for every 
developer worWng with C-h-. 

(BEFFC) Our Price $38.68 


DeBabelizer 

by Use Oespres and Paul Vachier 

DeBabelizer: The Authorized Edition is the 
official guide for Web designers, 
multimedia creators, artists and production 
specialists who want to take advantage of 
this powerful tool. 

• Create graphics and images for the Web that download fast and 
look amazing 

• Optimize graphics for CD-ROM, video, and animation 

• Optimize and manage colors using the SuperPaletteffM) 

• Discover DeBabelizer lips and advice from industry experts 

• Master basic manipulation techniques, including rotation, scaling, 
cropping, and text overlay 

• Explore key production techniques in all areas of graphics 
processing 

(BDEBTAE) Our Price $40.50 




Symantec Visual Cafe 
Sourcebook 

by Cary A. Jardin and Pam Dixon 

Symantec Visual Cafe, the first visual Java 
development tool that gives programmers a 
sophisticated set of tools. This book teaches 
programmers how to use Symantec Visual 
Cafe to create Java applets. It provides a thorough introduction to 
the language and gives advanced Java programmers information on 
how to use Visual Cafe to create their own Java development tools. 
(BSYMSOUR) Our Price $39.99 

Web Security Sourcebook 

by Aviel D. Rubin, Daniel Geer and Marcus 
J. Ranum 

Technical tools and techniques for 
building secure web sites and 
applications 

This book shows web masters, web 
managers, and web designers the hands on 
programming techniques necessary to build secure web sites. 
Readers will learn how to secure the server, use firewalls and 
cryptography, write secure Java applets and CGI scripts and more. 
Companion Web Site includes source code examples plus updates 
on the latest security threats and techniques. 

(BWEBSER) Our price $29.99 

Buiiding An Extranet: 
Connect Your Intranet With 
Vendors And Customers 

by Julie Bort and Bradley Felix 

Building an Extranet will help companies use 
their Intranet capabililies to supply information 
to selected customers and vendors birough a 
secure Extranet. This book provides complete information and working 
details tor building the network behind Intranets and Extranets, 
designing the applications, and getting everything up and running. 
(BBLDEXT) Our Price $29.99 

The Java FAQ 

by Jonni Kanerva 

Java FAQ provides an insider's view of the 
Java’“ technology by posing 
and answering the most important, frequently 
asked questions about the Java programming 
language, Java applets, and Java stand-alone 
applications. The Java FAQ is unique in that it 
draws from the tens of thousands of questions sent to 
<java@java.sun.com> and provides authoritative answers direct 
from the creators of the Java programming language at JavaSoft. 
(BJFAQ) Our Price $27.92 
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APPLE ENTERPRISE SOFTWARE 


Getting Started With WebObjects 

by Apple Enterprise Software 

If you’re a first time user, start here to learn the basics of how to 
create and run WebObjects applications. 

(BGSWO) Our Price $14 

WebObjects Developer's Guide 

by Apple Enterprise Software 

A guide to building and understanding WebObjects applications. 
Takes a close look at the WebObjects scripting language. Additional 
sections explain the WebObjects architecture and tells you how to 
integrate your code into the request-response loop, create reusable 
components, create client-side components, take advantage of 
powerful Foundation Framework features, and more. Filled with 
example code. For all WebObjects programmers. 

fBWODG) Our Price $16 

D'OLE Developer’s Guide 

by Apple Enterprise Software 

Distributed OLE is available today, and this book shows you how to 
use it. Using real-world examples, the book steps you through the 
process of making your OpenStep objects available on Windows 
through OLE. 

(BDOLEDG) Our Price $22 

Discovering OPENSTEP, Mach 

by Apple Enterprise Software 



Object-Oriented 
Programming and Objective C 

by Apple Enterprise Software. 

An introduction to the principles of object-oriented programming in 
OPENSTEP and the official description ot the Objective-C language. 
Objeclive-C is easy to learn and use because it adds very little 
syntax to the C programming language. It's dynamic nature allows 
you to accomplish things not possible in most other object-oriented 
languages. For any OPENSTEP programmer. 

(BOOPOC) Our Price $24 

Working w/ interface Builder (for eof) 

by Apple Enterprise Software 

A hands-on, award-winning book designed to help you get your job 
done with the updated Interface Builder, released with NEXTSTEP 
3.3 and the Enterprise Objects Framework 1.1. For any programmer 
using Interface Builder to design objects that truly work in 
NEXTSTEP. 

(BWIB) Our Price $24 


Introduces programmers to NeXT's OPENSTEP 4.0 Deveirtoer product 
by guiding them through the creation of toree applications of 
increasing complexity. The tutorials demonstrate and explain 
programming techniques, Objective-C fundamentals, common APts, 
and usage of the developement tools. Along the way they present 
summaries of important concepts and paradigms. Tlie book also 
includes a chapter directing readers to programming resources, 
further informatiwi, and services such as fraining and support. An 
appendix offers a concise discussion of object-oriented programming. 
(BDOSTEPM) Our Price $15 


Using EOF 2.1 w/ OPENSTEP (Mach & Windows) 

by Apple Enterprise Software 

Using Enterprise Objects Framevirork with OPENSTEP describes how 
to create an Enterprise Objects Framevrork application on 
OPENSTEP. it includes a tutorial and a chapter on creating a user 
interface for an OPENSTEP Enterprise Objects Framework application. 
(BUEOFO) Our Price $14 

EOF Developer's Guide for EOF 2.1 (Mach & windows) 

by Apple Enterprise Software 


Discovering OPENSTEP, Windows 

by Apple Enterprise Software 

Discovering OPENSTEP provides an introduction to OPENSTEP 
programming on Windows NT. It guides the reader through the 
creation of three applications of increasing complexity. Along the way. 
it explains concepts and illustrates aspects of Objective-C, OpenStep 
classes, the development environment, and programming techniques. 
A short appendix offers a summary of object-oriented programming. 
(BDOSTEPW) 0urPrice$16 


The Enterprise Objects Framework Developer's Guide describes how 
to develop database applications using the Enterprise Objects 
Framework tools and classes. It includes an architectural overview of 
the product, and descriptions of programming tips and techniques. 
An appendix offers a summary of Entity-Relationship Modeling. 
(BEOFDG) Our Price $24 

EOF Developer’s Guide for EOF 2.0 {BEOFDG20) Our Price $24 
EOF Developer's Guide for EOF 1 .x (BE0F0G1X) Our Price $24 
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Rhapsody Developer’s 
Guide 

by Jesse Feiler 

Covers the basic architectural principles 
of Rhapsody: the Mach microkernel, 
object-oriented programming, and the 
elements of a modem OS such as 
preemptive multitasking, protected 
memory, and symmetric multiprocessing. 
Also shows ways of getting to this new environment—Objective C, 
conversion tools, and the integration of Java—to develop Rhapsody 
products. Paperback, 450 pages. 

(BRDG) Our Price $35.95 

Designing 3D 
Graphics 

by Josh White 

In this powerful book/CD-ROM package, 
top computer graphics artist Josh White 
tells you everything you need to know to 
create sophistical^ real-time 3D 
graphics for computer games and 
virtual reality. This book contains the in- 
depth knowledge of software tools and 
hands-on modeling techniques that Josh White has learned while 
creating artwork for over 20 commercial games, including Descent, 
Zone Raiders, Locus, Legoland, and others. 

(BD3DG) Our Price $35.95 
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computer 

^graphics 

works 


The Way Computer 
Graphics Works 

by Olin Lathrop 

A complete guide to mastering 
computer graphic basics. It is written 
in a frank, down-to-earth style 
covering everything from how 
computer graphics are different from 
fine art and photographs, to modeling, 
pixels, and the pnnciples ot animation. 
All of this is done without resorting to mind-numbing equations and 
impenetrable technical jargon. 

(BWCGW) Our Price $29.65 

Debugging Macintosh 
Software 
with MaesDug 

by Konstantin Othmer and 
Jim Straus 

MacsBug, from Apple Computer, Inc., 
is the leading debugging software 
program tor the Macintosh. This 
book/disk package is an all-in-one kit 
for using MacsBug. Chapter 1 introduces MacsBug and describes 
the contents of the rest of the book. Chapter 2 describes how to 
install MacsBug and enough low level details about the Macintosh 
so that you can use MacsBug. Includes MacsBug 6.2 on disk. 
(BDMSWM) Our Price $31.45 





Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


Practicai Object- 
Oriented Deveiopment 
in C+-I- and Java 

by Cay S. Horstmann 

This book otters advice on real-wortd 
ways to use these powerful 
programming languages and 
teciinigues. Using the Unified Modeling 
Language (UML) methodology, expert 
Cay S. Horstmann gives you clear, concise explanations of object- 
oriented design, C-h-, and Java in a way that makes these potentially 
daunting operations more accessible than they've ever been before. 
(BPOOD) Our Price $31.50 

WebMaster in a Nutsheil, Deiuxe Edition 

by O'Reilly & Associates, fnc. 

Cross-platfonn, completely portable, and lightning fast, 
the CD-ROM is an invaluable addition to the 
webmaster's toolbox. The CD-ROM contains the Web 
Developer's Libaray—^the full text of the latest editions 
of five popular O’Reilly tides: "HTML: The Definitive 
Guide, 2nd Edition"; "JavaScript: The Definitive Guide, 2nd Edition"; 
"CGI Programming on the World Wide Web"; "Programming Perl, 

2nd Edition": and "WebMaster in a Nutshell." The Deluxe Edition 
also includes a printed copy of "WebMaster In a Nutshell," the all- 
inclusive quick reference that belongs next to every webmaster's 
terminal. Includes CO-ROM & 356 page book. 

Requirements: The CD-ROM is readable on all platforms, but requires 
a web browser that supports HTML 3.2. Java, and JavaScript. 
(BWMNUTD) Our Price $62.95 






Programming For Hie 
Newton Using 
Macintosh, 2nd Edition 

by Julie McKeehan and Neil Rhodes 

This book gives you 
everything you need to 
create Newton 2.0 
applications. From the 
people wiio developed the 
Newton programming training materials for Apple Computer, this 
book uses a clear and comprehensive approach to teach you how to 
program the Newton. Includes a CD-ROM full of sample code and 
additional goodies. The samples include solutions to all of the coding 
examples found in this book. Each example and exercise also has a 
narrated QuickTime movie showing the solution from start to finish 
in Newton Toolkit. 

(BPFNUM2) Our Price $31.45 
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Wireless For 
The Newton II I 

by Julie McKeehan and Neil Rhodes 

A book that picks up where 
Programming for the Newton ieft off, 
teaching the reader how to deveiop 
Newton software on the Macintosh, The 
enclosed fioppy disk provides a sampie 
appiication, as well as a fuiiy functional 
demonstration version of Newton Toolkit. 

• Learn to develop Newton software on the Macintosh 

• Hands-on Newton environment training with sample code 

• Includes disk with sample source code for a Newton application, 
as well as demonstration NTK- the complete development 
environment for the Newton 

(BWIRELESS) Our Price $31.45 

JavaScript 
& Netscape Wizardry 

by Dan Shafer 

The perfect book to show you how to 
turn Netscape into your 
own personal, - - 

customized operating 
system, Provides the 
inside tips and 
techniques for making your Web 

pages much more attractive. Shows you how to use all of the key 
features of the JavaScript language, including objects, methods, 
properties, events, and much more. Includes CD-ROM with 
numerous Interactive scripts written in JavaScript you can add to 
your Web pages today, A complete set of the best Java applets. 
Useful plug-ins designed to supercharge Netscape and resources to 
help JavaScript programmers. 

(BJNWIZ) Our Price $31.45 


JavaScript 1.1 
Deveioper’s Guide 

by Arman Danesh and Wes Tatters 

Written by developers for 
developers. An advanced 
guide to creating 
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professional Web 
applications with 

JavaScript 1.1 as deployed in Netscape 
Navigator 3,0, Microsoft Internet 
Explorer 3.0, and LiveWire. Includes CD-ROM with Sun’s Java 
Developer's Kit, JavaScript and HTML Editors for Windows and 
Macintosh, 20 contributed ready-to-run JavaScripts and JavaScript 
examples from the book. 

(BJSDG) Our Price $44.99 


Web site: http://www.devdepot.com 




Linux Configuration 
& Instaliation, 

3rd Edition 

by Patrick Volkering, Kevin Reichard, and 
Eric F. Johnson 
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Linux, the leading UNIX variant, 
has garnered loads of attention 
within the UNIX community. The 
amazing thing about Linux is that you don't need a 
vrorkstaton to run it, Linux Configuration & Installation, 

Second Edition lets you run Linux today. Program with Linux using C, 
C-f-t-, Perl, and Tcl/Tk. The 2 CD-ROM pack offers one of the most 
popular Linux distributions, Slackware 96, and comes directly from 
Patrick Voikering, the creator of Slackware. 


(BLCi2) Our Price $35.95 


Increasing Hits and Selling 
More on your Web Site 

by Greg Helmstetter 

Written especially for entrepreneurs, 
corporate marketing managers, small 
business owners, and consultants, ttiis 
valuable guide gives you rare tips and tricks 
you need to know to make your site a commercial success, 

$22.45 

HTML Sourcebook, 3rd 
Edition 

by Ian S, Graham 

Critics everywhere agree, HTML Sourcebook 
is tine best guide to HTML for Web 
professionals. That’s because no other book 
makes It so easy for you to quickly master 
all the commands, tools, and expert 
techniques you need to create cutting-edge 
Web page documents. Completely revised and expanded by nearly 
50 percent, this new third edition of the best-selling guide to HTML 
gives you the complete lowdown on all the changes and 
enhancements to the HTML, HTTP, and URL standards. 

(BHTMLS) Our Price $26.95 


Teach Yourself Java for 
Macintosh in 21 Days 

by Laura Lemay and Charles L. Perkins 
with Timothy Webster 

Add interactivity and muftimedia to Web pages! 

A step-by-step guide to make your Website 
come alive. Learn the basics of programming 
Java applets and the concepts behind the Java language. Includes CD- 
ROM with a limited version of Roaster, the first commercial, Integrated 
applet development environment for Java for the Macintosh! 
(BJAVAMAC) Our Price $36 

E-mail: orders@devdepot.com 25 
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Web Publisher’s Design 
Guide for Macintoshi 
2nd Edition 

by Mary Jo Fahey 

This is the only book that takes you 
step-by-step through real projects 
designed by talented new media 
artists. Internet design experts share 
their design secrets and art files (look 
for art files on the companion CD-ROM 
by artist's last name). This expanded new edition includes 
Photoshop, Illustrator and DeBabelizer tricks from the first edition 
plus countless new ways to ilven up your Web pages with 3D 
graphics, sound, movies, and much more. 

(BWPDG2) Our Price $35.99 
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BASiC for the Newton 

by John Schettino and Liz O'Hara 
Program on Macintosh, Windows-based PC, or on || ^ 


nclud^s 

Dtfk! 


the Newrton itself. Straight-forward “programming by 
example" approach - you'll be writing Newton programs right away. 
Includes 3.5" disk containing Demonstration NS B^IC and over fifty 
example programs (Newton not included). 

(BNEWT) Our Price $32.35 

SEE RELATED CATEGORY: Dev. Environments 



HTML For The Worm 
Wide Web, 2nd Edition 

by Elizabeth Castro 

Teach yourself Hypertext Markup 
Language the quick and easy way! This 
Visual QuickStart Guide uses pictures 
ra^erthan lengthy explanations. You’ll 
be up and running in no time, if you 
need to learn HTML fast - this is book 
is for you. 

(BHTMLW2) Our Price $16.15 


Getting Hits-The 
Definitive Guide To 
Promoting Your Website 

by Don Sellers 

Getting Hits explains in easy-to- 
understand language the underlying 
concepts behind the art of Web site 
promotion. Just a few of the topics 
you'll learn include: using search 
engines with URL’s; finding related internet groups or lists; 
understanding the nuances of click throughs and ad rates; and 
distributing press releases to key Internet contacts. With this book, 
you'll go beyond the conceptual and actually follow real-world tested 
promotional campaign strategies. Bring the wodd to your Web site! 
(BGHITS) Our Price $17.95 
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Programmer’s Toolbox 
Assistant CD-ROM 

Instant electronic access to 
Inside Macintosh essentials, 
by Addison-Wesley Publishing 

Get quick access to reference pages for over 
4,000 Toolbox calls in your system software 
from their development environment. Essential 
information for Macintosh software developers. Hypertext links allow 
programmers to view related topics easily. The ultimate electronic 
reference tool for Macinlosh programmers, 

(STBASST) Our Price $89.95 


OPTIMIZING 

CODE 



Optimizing PowerPC Code: 
Programming the PowerPC 
in Assembly Language 

by Gary Kacmarcik 

Take full advantage of the potential of the 
PowerPC by mastering the Assembly 
Language techniques. Learn to produce 
faster more robust software! 

(BOPTPPQ Our Price $35,96 




Macromedia 
Shockwave for Director 

by Jason Yeaman and 
Victoria Dawson 


The complete resource tor creating 
Shockwave movies on the Web. This 
hands-on reference makes it easy to 
aeate Shockwave movies and put 
them on the Web. Expert tips from the 
creators of Macromedia's first 
Shockwave movies, together with detailed examples and instruction, 
provide everything you need to get started. Includes CD-ROM. 
(BMSFD) Our Price $27 
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JavaScript For The 
World Wide Web 

by Ted Gesing and 
Jeremy Schneider 

This book takes an easy, visual 
approach to teaching JavaScript, 
where pictures guide you through the 
software and show you what to do. 
Works like a reference book, you look 
up what you need and then get straight 
to work. No long winding passages, rxrncise, straightforward 
commentary explains what you need to know. 

(BJVI/VI/VI/) Our Price $16.15 
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Metrowerks CodeWarrior 
Programming 

by Dan Parks Sydow 

Includes CodeWarrior Lite, and Full Coverage of PowerPlant™. Tbe 
best information on Metrowerks CodeWarrior, giving full coverage to 
tbe Gold Edition. CD includes Code Warrior Lite. 

(BCWPROG) Our Price $35.95 

CodeWarrior Software 
Development Using PowerPiant 

by Jan L. Harrington 

C++ programmers will learn to develop object-oriented software 
applications for the Mac and Power Mac using the PowerPiant 
environment and the classes that support it. Covers CodeWarrior 8. 
Included CD-ROM contains source code for ail the programming 
examples in the book and Metrowerks CodeWarrior Lite. 
(BCWSWDEV) Our Price $31.45 

inside PowerPiant 

by Metrowerks 

Create PowerPiant applications using the CodeWarrior IDE and 
PowerPiant Constructor. Full descriptions of major PowerPiant classes 
and resources. Included are the PowerPiant Constructor Manual, 
including View, TextTraits and Custom Types editing, and PowerPiant 
Library Reference, covering all classes and functions in PowerPiant, 
(BINSPP) Our Price $34.95 
SEE RELATED CATEGORY; Dev. Environment 



System 7.5 Technologies 

by Apple Computer, Inc. 

• Self-paced course designed to allow 
software developers to write code Biat 
extends the functionality of an application 
for System 7.5 

• Contains comprehensive materials for drag-and-drop, threads, 
standard mail package, and QuickDraw GX printing 

Students should be familiar with the basics of developing an 
application on the Macintosh. Metrowerks CodeWarrior Lite is 
included on the CD with the lab exercises. The lab assignments were 
developed in CodeWarrior 8. The labs can also be done in another 
development environment but prefect files for them are not provided. 

Training Format: Tutorial with tabs. 

Requirements: Macintosh or Mac-OS compatible computer with a 
68020 processor or greater (PowerPC preferred}; 8 MB RAM; 25 
MB hard disk space; System 7.5 or later; CD-ROM drive. 
(SSYSTECH) Our Price $49.95 



Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devclepot.com 


C-i-4- Programming 
with CodeWarrior 

by Jan L. Harrington 

Beginning OOP for the Macintosh and Power 
Macintosh and Mac OS compatibles. Learn 
object-oriented programming techniques 
using C++ as the example language and 
Metrowerks and CodeWarrior as the example 
compiler. Enclosed CD contains example code from the book and a 
full-function Metrowerks CodeWarrior. 

(BCPPCW) Our Price $32.35 





Learn C on The 


Macintosh Second 


Edition 

by Dave Mark 


New revised edition! Easy-to-understand - 
everything you need to start programming. 
Updated and enhanced exercises that lead you 
step by step. You'll learn function, variables, point datatypes, data 
structures, file input and output and more! Includes CD-ROM with 
Metrowerks CodeWarrior^^’ Lite. 


(BLEARNC2) Our Price $33.25 



Appie Guide Integration 

by Apple Computer, Inc. 


• Self-paced overview teaches you when and 
how to add Apple Guide help to your program. 

• Powerful help system that can guide the 
user through a task. 

• Tutorial will lead you through the steps necessary to integrate 
Apple Guide into your application. CodeWarrior Lite is included on 
the CD with the lab exercises. 


Training Format: Overview with labs. 

Requirements; Macintosh or Mac-OS compatible computer with 
68020 processor or greater, PowerPC preferred; 8 MB RAM; 25 MB 
hard disk; System 7.5 or later; CD ROM drive. 

(SAGI) Our Price $49.95 


Order Toll-free 
800-MACDEV-1 


I800622-3381I 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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AppleScript Language Guide 

by Apple Computer, Inc. 

A complete reference for anyone using AppleScript to modify existing xripts or to write 
new ones. Contains useful information for programmers who are working on scriptable 
applications or complex scripts. Features detailed definitions of AppleScript terminology 
and syntax in trie following categories: Value classes, commands, objects and 
references to objects, expressions, confrol statements, handlers, and script objects. 
Includes many sample scripts, dixusses advanced topics such as writing command 
handlers for xript applications, the scope of xript variables and properties declared at 
different levels in a xript, and inheritance and delegation among xript objects. 

(BALG) Our Price $26.95 
SEE RELATED CATEGORY: Scripting 


AppleScript 
Applications: 

Building Applications with 
FaceSpan and AppleScript 

by John Schettino Affiliation & Uz O’Hara 



Build complete AppleScript applications using 
FaceSpan. a user interface development tool 
that makes AppleScript applications truly 
“Mac-Like". Uses a step-by-step approach 
to demonstrate txhniques for building 
applications through Illustrations and 
samples. Provides Graphical Uxr Interface 
(GUI) design tips and practical approaches for 
implementation. Contains one CD-Rom with 
AppleScript 1.1, a demonstrations version of 
FaceSpan 2,1, xurce code for all example 
applications numerous AppleScript shareware 
and demonstrations programs. Contains a 
section on debugging AppleScript 
applications using FaceSpan. 

(BAPSCAP) Our Price 1^1.45 
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Special Edition 
Using CGI, 

2nd Edition 

by Jeffry Dwight, Michael Erwin 
and Robert Niles 

This romplete reference provides 
protossional Web developers and advanced 
personal uxrs with the latest information 

on using CGI (Common (Gateway Interface) to interact with databases. 

• Explains client and server uses of CGI 

• Provides extensive coverage of live audio and video feeds, user 
chat and interaction, and CGI xcurity 

• Features separate chapters devoted to language-specific tips, 
tricks, and traps 

• CD ROM is loaded with the HTML and CGI sample code from 
the book 

• Includes applications tor guest books, mail and new gateways, 
browser identification, access restriction, and shopping carts 
(BSEUCGI) Our Price $44.99 



JavaScript 

*'foh Macintosh 


JavaScript for the Macintosh 

by Matt Shobe and Tim Ritchey 
Allows non-programmers to lake rjjk \ 
advantage of the power of 
Netscape Navigator. Expand the 
capabilities of your Web page, without 
having to understand C or C-»-r. CD-ROM 
contains "Wizlets" that allows you to easily 


create your own JavaScripts. Takes you step-by-step through 
programming cross-platform JavaScripts. Details how to create 
JavaScripts for JavaScript-aware Web browsers. 
(BJAVASCRPTJ) Our Price $40.50 


Java in a Nutshell, 2nd 
Edition 

by David Flanagan 

A detailed overview of all of the new features 
in Java 1.1, both on a package-by-package 
basis and in terms of overall functionality. A 
comprehensive tutorial on "inner classes" 
that explains how to use ail of the new types 
of inner classes: static member classes, member classes, local 
classes, and anonymous classes. Practical, real-world example 
programs that demonstrate the new features in Java 1.1, ixluding 
objxt serialization, the new AWT event handling model, 
intemationalization. and a sample Java Bean. 

(BJNUT2) Our Price $17.95 

AppleScript Finder Guide, English Dialect 

by Apple Computer, Inc. 

Provides definitions for Finder object classes and commands. Write, 
record, or run scripts that trigger the same desktop actions that you 
trigger using the keyboard and mouse. 

(BAFG) Our Price $17.95 

SEE RELATED CATEGORY: Scripting 

Inside CodeWarrior Professional 

by Metrowerks 

Includes CodeWarrior IDE UseFs Guide. This is the printed version of the 
dxumentation provided on the CD. Ctovers CodeWamior Professional 
Release, the debugger and associated tools. 

(BINSCWP) Our Price $34.95 

SEE RELATED CATEGORY: Dev. Environment 
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3D Graphics 
Programming 
Using QuickDraw 3D 

by Apple Computer, Inc. 

Incorporate spectacular 3D graphics into 
your applications. Explore QuickDraw 3D, 
a revolutionary graphics extension to the 
Mac OS for Power Macintoshes, CD 
contains the complete QuickDraw 3D 
system itself and a complete database of the QuickDraw 3D API, 
allowing you instant access to the hundreds of graphics calls via a 
fast viewing engine. Book/CD-ROM, 640 pages, 

(B3DGRAP) Our Price $35.96 





Advanced Color Imaging 
on the Mac OS 

by Apple Computer, Inc. 

Enhance your software's color 
capabilities with step-by-step 
instructions. Augment the color support 
supplied with QuickDraw, and QuickDraw 
OX. Lise the Pallette Manager to get the 
best colors on limited displays. Match 
colors between screens and input/output devices (scanners & 
printers). CD includes a complete reference information in both 
QutckView and Acrobat formats. Plus, a sample application 
demonstrating ColorSync programming techniques. 

(BADVCI) Our Price $33.25 



Ik'icks of The 
Mac Game 
Programming Gurus 

by McComack, Ragnemalm, Celestin, et al. 

For beginning to expert game 
programmers. Complete overview of all 
the necessary components of game 
programming on the Macintosh. Packed 
with valuable tools, utilities, sample code, CodeWarrtor'^'^ Lite and 
game demos. QuickDraw 3D and Power Mac optimization and inside 
into on how Glypha 111 was created, Hundreds of fried-and-true 
tricks, tips, and insider secrets from well-known Mac game 
programming experts. 

(BTRICKS) Our Price $45 


Black Art of Macintosh 
Game Programming 

by Kevin Tieskoetter . „ ^ 

Develop your own 3D games in 
C on the Mac. Includes CD with 
project files for both Symantec 
C and Code Warrior. Create "" * 
freeform texture-mapped games and 
polygon graphics. Control dynamic source 
code - all compatible as native to the Power Mac. Write directly to 
the screen, bypassing QuickDraw. 

(BBLACK) Our Price $35.99 
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All entries in this index are alphabetized. For your convenience the product names 
are bold, book names are italicized and company names are in plain text. 
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000 , 000,000 

Have you seen this man ? 

Hacker Harry and the pirate gang are 
loose and robbing the software stagecoach. 

you want to stop them and collect your 
part of the reward... the place to find your 
New Generation Protection solution is at: 


The expected losses due to piracy in the software industry alone 
are over $15 billion for 1997. Some of this belongs to YOU. 
By using MicroGuard’s New Generation Copy Protection keys, 
you will enforce your rights and guarantee your profits. 

And now with MicroGuard PC’s newest innovative feature, 
' u ; tTt / ^ anyone can secure an entire application within 
a protective shield in 10 minutes or less. TRY IT. 




InternaiiurLai 

Micro Macro Technologies, Ltd. MiaoGuard 
SaishikmaSt. 631 South Pontiac St. 

P.O.B 0 X 115 16, Azur 58001 Denver, CO 8022-i 

Israel usA 

Tel; (972-3) 558-2345 Tel: (.303) 320-1628 

Fax: (972-3) 558-2344 Fax: (303) 320-1599 

E-mail; info@micrf)macro,com E-mail: usa@micromacro.ct)m 
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;Wh,en Rhapaody gets here 
11 be ready., .with 
'*<?bdeWarrior Latitude?* 


It's Metrowerks* newest 


I?* porting tool, designed to 
give you a lag up on 
^Rhapsody. Reeoraplle your 
.. lao OS souree code, link it 


with the Latitude libraries 


and find out which portions 
of your code are going to 
port smoothly... and which 
won't [forewarned'is fore¬ 
armed]. As Rhapsody evolves, 
so will Latitude; registered 
users will receive all 


developer releases, the 
first full release, plus 
one■ additional update. 
CodeWarrlor Latitude. $3; 


a' little attitude to boot 


metrowerks 


WWW. metrowerks.com 


























